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This manual was produced using WORDWISE PLUS II to drive a laser printer. 


WORDWISE is a trade mark of Computer Concepts. WORDWISE PLUS II (C) 1987 Computer 
Concepts and IFEL. 


All rights reserved. No part of this publication may be reproduced, stored in a retrieval 
system, or transmitted in any form or by any means electronic, mechanical or photocopying 
or otherwise, without the written permission of IFEL. 


Neither Computer Concepts nor IFEL can be held responsible for any loss of data due to the 
use of WORDWISE PLUS II. 


IMPORTANT 


WORDWISE PLUS II is supplied on a ROM mounted on a small circuit board. A single pin 
(possibly two, but no more) may appear to be missing. This is normal, so please do 

not return it as damaged. Detailed fitting instructions are supplied separately. 

Being 32K in length, WORDWISE PLUS II cannot operate “across the tube”. 


Acknowledgment 


Thanks are due to the staff of Computer Concepts for their assistance during the 
production of WORDWISE PLUS II. 


Existing files and Segment programs 


WORDWISE PLUS II is able to use WORDWISE PLUS text files without any modification 
whatsoever. WORDWISE users should note that minor changes have been made to some of 
the embedded commands. WORDWISE PLUS II will run existing segment programs, but 
there may be minor complications when keywords are abbreviated. Further details may 

be found on page 53. y 


"README" 


We are constantly enhancing the capabilities of WORDWISE PLUS II, but an unfortunate 
characteristic of printed manuals is that they cannot easily accommodate changes to 
the software. This usually leads to unforseen addenda being squashed in somewhere. 


To overcome this problem we supply a text file on the “Segment programs” disc called 
“README”. The idea is that this file should be loaded into WORDWISE PLUS II and 
printed out (or just go into edit mode to read it). In this way, we can draw your 
attention to the latest additions or changes. Although arguably less convenient than 
printed sheets, this approach has several advantages. Errors are easy to correct, and 
plenty of examples can be included. Load the file into memory thus; 


1) *WORDWISE 

2) Press 2 

3) Enter the filename, and then press 

4) When the file has loaded, takes you into edit mode. 
5) Use the cursor ("arrow") keys to scroll through the document. 


Note: “README” may not be in the root ("$") directory, which helps it to stand out when 
*CAT is used to catalogue the disc. Be sure to include the directory letter at step "3" 
above. Eg. “T.README” 


INTRODUCTION 


The original WORDWISE word-processor quickly obtained a well-earned reputation for ease of 
use and flexibility. Its successor, WORDWISE PLUS, enhanced WORDWISE in a number of 
important ways, particularly by including a versatile programming language. This language 

is very easy to use and allows programs to be written to perform mail-merging, label 
printing and so on. Furthermore, the segment concept allows you to have up to eleven 
separate documents in memory simultaneously. 


WORDWISE PLUS II retains all the familiar features and mode of operation of 
WORDWISE/PLUS. A large number of extra facilities have been incorporated however 
which make the process of editing and manipulating text much easier. 


All of the WORDWISE series word-processors use mode 7 for editing text, and there are two 
advantages in this. One is the obvious point that it is clear to read (especially for 

prolonged periods), and the second is that it permits rapid editing. The so-called WYSIWYG 
("wizzy-wig", What You See Is What You Get) word-processors are noticeably slower when 
manipulating a document, because of all the screen reformatting which has to take place. 

In these days of printers which can produce a multitude of different type styles such as 
double width or proportional spacing, it often happens that WYS isn’t WYG anyway. 


The WORDWISE PLUS II package consists of three main parts, the ROM itself, this manual and 


support disc(s). It is hoped that the extra facilities incorporated on the ROM are ones 
which everyone will find frequently useful. Examples here are the additional keys 
for easier editing. On the other hand, the utilities disc contains such items as a label 
printer and a mail-merge program. Although useful in their own right, they are unlikely to 
be needed as a matter of routine. Hence we feel that tasks which are most easily achieved 
with a segment program are best put on a separate disc, rather than by dedicating part of 
the space available on the ROM to them. They may nevertheless easily be accessed if and 
when required. 


We have a number of additional utilities designed for use with WORDWISE PLUS II. There is 
a fast sorting routine which is invaluable when dealing with names and addresses. 

Typically, 100 addresses can be sorted in about a second. The routine is very versatile, 
allowing sorting by eg surname, ascending or descending order, numerically or 

alphabetically etc. The program is not restricted to addresses, so it is possible to sort 

lists of eg names, towns, your record collection etc. 


Also available is a "continuous processing” routine, which permits very long documents (ie 
those which are too long to fit into the computer’s memory) to be written with relative 
ease. There is virtually no limit on overall document size when using this program. A disc 
is available which shows how to read and set the Master’s real time clock using WORDWISE 
PLUS II. Please ask for further details about these and other products. 


SPELL MASTER 


This is without doubt the spelling checker for the BBC Microcomputer. It scores heavily on 
convenience and checking speed, two of the most important qualities to look for. It is 
convenient because in order to initiate the check, you merely press a single CTRL key. Any 
words which are flagged as incorrect can simply be ignored, added to a user dictionary, or 
corrected. You can check the word at the cursor, or just the marked section of text. It is 
even possible to activate a "check-as-you-type” mode, which immediately alerts you to any 
likely problems, but never forces you to take corrective action. And all this takes place 
from within edit mode of WORDWISE PLUS II. 


Since it has no moving parts, the checking speed is in the order of 10,000 words per 
minute, far ahead of the disc-based “competition”. Spell Master has about 57,000 words 
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built into a single ROM, but other words can easily be added by means of “user 
dictionaries" in sideways RAM. Spell Master (designed by Computer Concepts) can be 
obtained from IFEL. 


HOW TO USE THIS MANUAL 


As mentioned above, WORDWISE PLUS II is virtually identical in operation to WORDWISE PLUS. 
After all, why change a well established formula? The best approach to this manual will 
therefore depend on your previous experience (if any) of WORDWISE PLUS. 


The last part of the manual deals with some of the fundamental WORDWISE PLUS concepts, 
which of course apply to WORDWISE PLUS II also. For example, the keywords in the 
programming language are summarised, and the embedded commands are listed. We also 


illustrate the usefulness of the whole segment programming concept, the feature which puts 
WORDWISE PLUS II into a league of its own. 


If you have never used WORDWISE PLUS before, there is probably little point in reading the 
first section of this book initially. It is far more important to become familiar with the 
fundamentals of entering and changing text. We therefore Suggest that you read through the 
“WORDWISE PLUS basics", and only refer to this part of the manual if absolutely necessary. 


Experienced WORDWISE PLUS users can move straight into the next section. 


SOME CONVENTIONS 


In order to avoid repetitive explanations later on, we will summarise here the meaning of 
various symbols used in this manual. 


GSM. Press the key marked RETURN. Similar comments apply to eg and [agyy. 


ig. The cursor up key. The extension to EW3ag, (YaTig and is obvious. 
y 


GH. One of the red function keys 0-9 


Occasionally, two or more keys must be pressed simultaneously, often when using the 
function keys. We denote operations such as these as follows. 


Salimfaisy Means press the key and function key five (in this case) together. Make 
sure that you press the key first. 


Salmeediiears Means press both BGullagkety@, and then . 


It is also important to distinguish between the two main operating modes supported by 
WORDWISE. These are the edit mode, easily identifiable by information such as “Words” and 
“Free” on the top line. Edit mode is the one used for entering and changing your text, and 
applies both to the main text area and each of the ten segments. 


There is also the main menu, reached by pressing from edit mode, and which will 
have nine options clearly printed on the screen. In fact, there are two menus; text and 
segment. The former is the one which is active as soon as you enter WORDWISE PLUS II, and 
the latter is specifically selected by using option 9 of the text menu. The "SEGMENT MENU” 
title replaces WORDWISE PLUS II at the top of the screen. Later on in this manual, we will 
sometimes need to be quite clear as to whether the text or segment menu is active. 


Page-2 


Brief summary 

WORDWISE PLUS II may be entered by the familiar *WORDWISE command. It is also 
possible to specify which particular area (text or segment) should be activated, and 

also to indicate that a named file should be loaded. E.g. 

*WOR. MYPROG 

enters WORDWISE PLUS II, and tries to load "MYPROG”. 

*WORD. “7 

enters segment 7. 


*WORDW. “8FRED 
enters segment 8 and loads file “FRED”. 
The details... 


As you will know, the usual way of entering WORDWISE is by means of the command 


*xWORDWISE 


Often an abbreviation can be used (depending on the other ROMs in your machine), such as 


BU RETURN 


WORDWISE PLUS II allows you to start up in this way too, but there are some other 
permitted variations. 


It often happens when starting WORDWISE that you wish to begin editing a particular file, 

as opposed to producing a completely new document. If this is so, it can be convenient to 

have the desired file loaded directly rather than having to use menu option 2 (Load Text) 

to select it. WORDWISE PLUS II therefore permits an optional filename after the *WORDWISE, 
and this file will be automatically loaded. For example 


*WORDWISE MYFILERZS@a 


will start up WORDWISE PLUS II, and attempt to load the file "MYFILE’. The “WORDWISE” 
may be abbreviated in the usual manner, and the filename may have drives and 

directories included. Additionally, like all * commands on the WORDWISE PLUS II ROM, 

the letters "IF" may be used as a prefix. Thus 


*IFWOR. :2.W.00C1(§RTRY 


will enter WORDWISE, and attempt to retrieve the file DOC1 from the "W™ directory on drive 
2. In practice, the “IF” prefix is unlikely to be needed for the *WORDWISE command. 


When WORDWISE PLUS II is first entered, it will usually make a short beep. This indicates 
that a “hard” start has taken place, and that the text area and ten segments will be 

empty. The user will find that the main menu is active, as opposed to the segment menu. 

You can move to any chosen segment by using option 9 from the main menu, and then option 5 
from the resulting segment menu. An alternative (often easier), is to use [@ggW@My, where 

n is a number in the range 0-9. 
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It is possible to specify the particular area (text or segment 0-9) which should be active 
upon entry into WORDWISE PLUS II. This is achieved by use of the "*" character, just under 
the key. This character should be followed by either a letter ’T’ (for Text) , or 
a number 0 to 9 representing the chosen segment. Hence 
*WORDW.  *SiSE 
enters segment five. As before, a filename may be included, so that 
*WOR. “2LETTERPEQED 
starts WORDWISE in segment 2, and tries to load the file "LETTER" into memory. 
There is one other option, which makes use of the "*" character. Typing 
*worD. *(HI 
will enter WORDWISE PLUS II, and invoke the menu-driven file selection program. From here 
you can enter or select (with the cursor keys) any file, and even use star commands. More 
information can be found in the section entitled "Loading and saving”. 
Sooner or later, most users discover that it is possible to have a document in 

memory, exit to BASIC (using *BASIC from the menu), enter WORDWISE PLUS again, and 

unwise. Although it is often possible to get away with it, side effects can easily occur 

which do not become apparent until later. Always save your text and segments before moving 


EXITING AND RE-ENTERING WORDWISE PLUS/II 
find their text intact. It cannot be over emphasised that this procedure is most 
into any other language. 


Brief summary 

The WORDWISE PLUS II main menu indicates how many bytes are left to store text, and also 
the amount of free space in the string ($) buffer. It also shows the current “wildcard”, 

and whether case sensitivity is on or off. The wildcard could be changed to a "&" (say) by 
using the command 

*WILDCARD &fSiy 

*CASE and *NOCASE will turn case sensitivity on and off respectively. 

You can also use to make these changes. Use or XQ] to move the coloured 
highlight onto the quantity to be changed, and enter the required parameter. Notice that 

it is possible to select the keyboard repeat delay/rate from this menu, and also the 


condition that the CAPS LOCK adopts in both edit and menu modes. The or 
keys can be used to alter them. 


ULSTAy can be used to delete the text area, confirmation being required first. 
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The details... 


The most obvious difference between WORDWISE PLUS II and its predecessor is that 
additional information is displayed on the main menu. This is; 


“FREE”; The number of bytes remaining for text storage. This will be the same as the 
number shown after “Free” when you enter edit mode. There is nothing much you can do to 
change it (other than by editing the text of course) but it can be handy to be able to see 
at a glance how much memory remains. 


"$". This is the number of bytes free in the string variable storage area. It has a 
maximum value of 437. If you never become involved with running segment programs, then 
this figure is unlikely to be of much concern, or indeed to alter significantly. It is 

worth noting however that the last filename used for loading or saving the main text is 
stored in the string variable F$. Every time a new file is loaded or saved, F$ is updated 
accordingly. If there is insufficient room to store the new name however, you will obtain 
a "No §$ room” error. 


It is most improbable that this will happen, but if it does the only way in which you can 
easily save your text is to make room for the new name. To do this, type 


CLEARS 


from the menu, and then select a new menu option as appropriate. The CLEAR command is 
explained in more detail under “ADDITIONS TO WPPL” 


“Wildcard” 


When using WORDWISE to perform (say) search and replace operations with menu option 5, it 
is often useful to have available a symbol which can mean “any character”. In both 
WORDWISE and WORDWISE PLUS, this symbol was the (unalterable) hash character, “#". Thus, 
if the search string was specified as “c#t", words such as ‘cat’, ‘cottage’ cutlery’ and 

so on would all be affected. 


It can sometimes be inconvenient to always have "#" as the wildcard. As a general rule, if 
the symbol being used as the wildcard already occurs in the text, complications may arise. 
This is precisely why the "#" is normally selected, since it is unlikely to appear in most 
documents. 


For 99% of the time therefore, the wildcard can be left on its default setting of wae" AE 
you do wish to alter it (perhaps because you are producing specialised material which 
needs to have hashes in the text), there are two ways of doing so. 


The first is by means of [@QYWEJ. The resulting display is described in more detail under 
“ADDITIONAL CTRL KEYS", but we will give a brief description of the process here. 


Having pressed J@gi@Ag, use the | DOWN] key to move the highlight section onto the 

“Wildcard” option. Then just enter the character that you wish to be used as the new 
wildcard. Virtually anything will do, but we make the point again that it should be 

something “unusual”. Press to exit back to the menu. 


The second method is to use the *WILDCARD command. This too is described in more 
detail later on, and suffice it to say here that you can change the wildcard to a “he” 


(say) with the command 


*WILDCARD */GEGi) 
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Again, abbreviations are allowed (e.g. *WIL.). 
“Case sense” 


Case sensitivity is the name given to the ability to distinguish between upper and 

lower case letters. If case sensitivity is on, then the words "ROM" and “rom” are 

treated as being quite distinct from one another. The outcome of search and replace 

type operations are clearly dependent on whether the computer is considering the case 

of the letters in words. Both WORDWISE and WORDWISE PLUS only permit case-specific 
searches. WORDWISE PLUS II gives you a-choice. 


Case sense will either be shown as "On" or "Off", "On" being the default condition. It may 
be changed by means of from the main menu, and the procedure is as follows. In 
response to RGGTWTY, select the “Case sensitive” option using or EM. This has 

the default of "Yes" (i.e. case sense "On"). It then only remains to use or 

to select the appropriate choice of “Yes” or “No” and then press | ESCAPE} 


There are also two star commands which relate to case sensitivity. These are *NOCASE (i.e. 
case sensitivity off), and *CASE. Those users familiar with segment programming will 
appreciate the importance of these when you consider that the FIND and REPLACE commands 
are both affected by the wildcard and case sense. 


It is important to remember that the result of option 5 of the main menu (search and 
replace) can be affected by both the wildcard and case sensitivity, which is why the 
existing settings are clearly displayed. 


You will notice that also provides the opportunity to change such things as the 
"Repeat rate" and "Caps (Edit)". This is described under “ADDITIONAL CTRL KEYS". 


From the segment menu option 8 will delete the current segment. There is not normally any 
equivalent facility for deleting the text area in a similar fell swoop. From the main menu 

in WORDWISE PLUS II however, enables the text to be deleted. An “Are you sure?” 
Prompt is given to lessen the risk of accidental erasure. 


Remember that the effect of [@iNW@P) in edit mode (segment and text) is quite 
different - it deletes the word at the cursor. 


THE SEGMENT MENU 


The additional information provided by the segment menu is restricted to the number of 

free bytes, both in memory and the string buffer. It is not possible to use to 

change the wildcard or case sensitivity. Of course since there is no menu option for 

search and replace, this hardly matters. *NOCASE, *CASE and *WI LDCARD may still be 
used however, although the effect will not be apparent until you return to the main 

menu. 


THE EDIT DISPLAY 


WORDWISE PLUS II displays the current Position of the cursor as a number between 0 and 39, 
on the top line of the screen. This can prove useful when trying to decide where TAB stops 
should be set, or by how much a Paragraph should be indented to make it line up with 
something else etc. “Characters free’ has become just “Free” in order to make room for the 
"Cur-" message. Other than this, the displays in WORDWISE PLUS and WORDWISE PLUS II are 
identical. Identical also are the keys used to move around the document. 
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LOADING AND SAVING TEXT 


Brief summary 


Like WORDWISE PLUS, WORDWISE PLUS II will display the previous filename during load and 
save operations. You can use the cursor keys to edit it as normal, but in addition 

pressing at any time causes the previous filename to be copied onto the input 

line. It can then be altered if needed. Press to terminate the entry. 


Just as F$ is used to hold the last filename used for the main text, so S$ retains the 
last segment filename. 


The details... 


It has already been said that when a file is loaded or saved from the main menu (as 
opposed to the segment menu), the filename is stored in the variable F$. You will have 
noticed that whenever WORDWISE PLUS asks for a filename to be entered, it also displays 
the last filename used (if any). 


Saving your text at regular intervals is strongly recommended, typically every ten minutes 
or so. It is also useful to choose related but not identical filenames, such as DOC1, 

DOC2, DOC3 and so on. This helps to minimise the impact of mains failure or a corrupted 
file, since you should always be able to retrieve an earlier version. By the time you get 

to DOCS, the time has perhaps come to delete some of the earlier versions and start 
numbering from 1 again. It is surprising how quickly a disc can fill up with files such as 
JUNK7, TEMP9 etc! 


Normally, once WORDWISE PLUS has displayed the previous filename on the screen, it may be 
copied either partially or completely using the cursor and keys. This makes it 
relatively easy to enter slight variations on the original name. 


This works in the same way in WORDWISE PLUS II. The previous filename can easily be edited 
by using the cursor keys together with [@@GXJ. The presence of a white block characterises 
this editing mode. 


on its own has the useful property of copying the entire previous filename down 
onto the input line, but only if no cursor keys have been used. As soon as you press a 
cursor key, the white block appears, and makes a copy of the character above the 
flashing cursor. on its own is handy when you wish to make suffix changes. 
may then be used to erase unwanted characters, or any additional characters typed in. Just 
press when the desired name has been obtained. 


In order to see how convenient this is in practice, let us give a short example. For the 
purpose of this demonstration, we must first of all ’fool” WORDWISE PLUS II into thinking 
that the last filename used was "LETTER3”, and this can be achieved by typing (from the 
main menu) 


:F$="LETTER3 "GE 


Press the space bar (you are being prompted to "Press any key”), and then press the "1" 
key, the "Save Text” option. 


At this point WORDWISE PLUS II displays the previous filename which it now thinks was 
LETTER3, and then asks for the new filename to be entered. In keeping with the idea that 
sequentially numbered filenames are required, let us suppose that we wish this to be 
LETTER4. The key presses needed would be; 
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Loading and Saving 


This produces the name LETTER3, since this is the complete previous 
name. 

This gets rid of the "3", making the name become “LETTER” 

4 Makes the name into "LETTER4” 

Terminate entry of the new name. 


There is nothing to prevent you from entering "LETTER4” just by typing it directly, but 
the use of the key is often quicker. 


This technique applies to all of the menu options 1-4. 


Observe how easy it is to save or load a file with exactly the same name as before. Just 
select 1~4 from the menu, press [ee]4@ and then EYSanTTy. 


LOADING AND SAVING SEGMENTS - S$ 


The segment menu resembles the main menu in many ways. In particular, options 1~4 serve 
similar purposes. 


WORDWISE PLUS does not ’remember’ the last filename used for saving a segment, only the 
main text. This is a slight inconvenience, because segments can be used for entering text 
just as easily as the true text area. 


This shortcoming is taken care of in WORDWISE PLUS II. In the same way that F$ is used to 
store the last filename used for loading/saving the main text, so S$ is used for the same 
purpose with segments. In other words, if you saved a segment to disc with menu option 1 
under the name "SEGO", then "SEGO" would be assigned to the string variable S$. 


WORDWISE PLUS II displays the previous filename when loading and saving a segment. It also 
allows the key to be pressed, and has the effect of copying the contents of S$ onto 

the line requesting a filename. Transferring segments to and from disc is now considerably 
easier, particularly if you want to keep the same name. It is merely a question of 

selecting the required option 1-4, press [@@GMJ, and then GU. 


The effect of the key is seen to be identical to that in the main menu. The only 
difference is that S$ is being used for the filename rather than F$. 


S$ does not distinguish between the different segments. Thus if you save segment 0 (say) 
under the name “"MYSEG” and then move to segment 8, "MYSEG” wiil still be considered to be 
the current filename. 


SAFETY-NETS IN LOADING AND SAVING 
Brief summary 


WORDWISE PLUS issues prompts requiring confirmation before certain operations are 
performed. (E.g. “Are you sure?” etc). WORDWISE PLUS II also includes these features, but 
in addition it will unlock locked files during save operations rather than aborting with a 
“Locked” error. It clearly indicates whether or not a file that is about to be replaced is 
locked. 
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Loading and Saving 


The details... 


WORDWISE PLUS makes some attempt to warn the user if text in memory is in danger of being 
overwritten, or if an existing file is about to be replaced. This helps to reduce the risk 
of accidental loss. 


WORDWISE PLUS II offers similar prompts, such as “Are you sure?” when attempting to load a 
file into memory, and the target area is not empty. 


The "Replace old file?" message is also issued when you try to save a file under a name 
which is already present in the disc catalogue. 


WORDWISE PLUS II differs from WORDWISE PLUS here in that it will detect and deal with 
locked files. Files are locked by using the *ACCESS command. If you try to save the text 
under a certain name and the same file already exists and is locked, the prompt 


Locked 
Replace old file? 


is given. Replying “Y" will cause the old file to be unlocked, replaced with the new data 
in memory, and finally locked again. Any other key press will abandon the saving process. 


Remember that locking a file is supposed to be a way of preventing it from being deleted 
or altered too easily. Think twice therefore before replacing a file if WORDWISE PLUS II 
tells you that it is locked. 


N.B. When working with the ADFS, files can have certain “access attributes” in addition to 
being locked. WORDWISE PLUS II will not attempt to change such attributes, since it is 
felt that this would be more likely to lead to accidental erasure of important data. It is 
possible for a save type of operation to abort with an “Access violation” error. You will 
need to use the *ACCESS command (see J.7-1 of the Master Reference Manual part one) to 
reset the file attributes correctly. 


Technical Note 


Certain types of DFS have been found to cause problems here. For example, unlocked files 
become unexpectedly locked and vice versa. The coding in the WORDWISE PLUS II ROM uses 
only legal calls, and we are confident that the fault lies in the DFS ROMs concerned. If 

you experience difficulties such as these, we can supply a special version of WW+2 which 

has the automatic locking and unlocking feature taken out. This completely solves the 

problem. 


OTHER LOAD AND SAVE OPERATIONS 
Brief summary 


A very convenient display of all the files on the disc may be obtained by means of 

through to from the WORDWISE PLUS II menu. You can use the cursor keys 
to select a filename on the screen, and then press [QMUIINJ. Alternatively, just enter the 
filename at the keyboard. The key has the effect of copying the currently 

highlighted file onto the input line, and it can then have characters added or deleted as 

normal. ’Star’ commands are permitted, so it is possible to change drives or directories 

without returning to the menu. 
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Loading and Saving 


The details... 


WORDWISE PLUS II provides another way of loading and saving text/segments. The basic idea 
is that a complete menu of all the files on the disc is displayed, and the user is then 

free either to enter a new filename, or to select an existing one. This type of facility 

comes into its own when the disc contains a fairly large number of files. The use of one 

of the options 1~4 on the menu has certain advantages however. It is very easy, and is 

often the quickest way of loading a particular file. By providing both methods of file 

loading, you can select whichever seems most appropriate at the time. 


Notice that the last paragraph has been referring to disc usage. In fact, this section 

applies to the DFS, ADFS and network filing systems. It will not work with cassettes or 
the ROM filing system. They are both too slow to make the technique viable. Nothing will 
happen apart from a “Press any key” message if an invalid filing system is active. 


The file catalogue display is obtained by pressing together with one of the keys 

1-4. For example, will activate the "Save Text” routine, and [RXI@@2§ will load 

a file at the current cursor position. This will work from both the main menu and segment 
menu, but not edit mode of course. As usual, if there is any text in memory and the chosen 
option would delete it, you will receive an “Are you sure?” message. This will require a 
“Y" response before you can proceed further. (This does not in itself destroy the text, so 
there is still the opportunity later on to abandon the load option, and return to the 

original document). 


Start off by putting into the drive a disc with several files on it (preferably text 
rather than BASIC programs!). Then press to invoke the “load to cursor” routine. 


The resulting display is roughly divided into three sections. The top line indicates the 
target area, either text or a segment O to 9. It also shows which type of operation has 
been selected, e.g. Load Text, Save marked section etc. The extreme right will show the 
current drive and directory in the case of the DFS. 


Any characters typed in appear on the bottom line. This will usually be the chosen 
filename, but “star” commands are permitted too for reasons that will be explained in a 
moment. 


The central portion is dedicated to the names of the files on the disc. For convenience 
they are arranged in alphabetical order. 


The four cursor keys may be used to move a coloured ’highlight’ onto any filename. No 
highlight is present initially, but it may be obtained by either pressing (in which 
case it will appear at the top left hand corner), or by using a cursor key. 


There are essentially two ways of entering a filename. One is simply to type it in as 
usual, ending with [QQUEN). As you do so, you will notice that the highlight moves onto 
the filename which most closely matches the current input line. The highlight may vanish 
altogether if there is no match, but it can always be made to appear again with the 
key. 


The second method is move the highlight onto the chosen filename, and then press [aaeiyJ. 

If a highlight is visible, then the key has the effect of copying that highlighted 

file onto the input line. It can then be modified as required using etc. If a 

cursor key is pressed, it always causes anything on the current input line to be erased. 

“Star” commands may be entered without returning to the WORDWISE PLUS II menu. This make 
it possible to changes drives, directories, *DELETE files, use the *ACCESS command etc. Be 
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careful to spell * commands correctly, otherwise the file menu may be aborted when the 
machine produces a "Bad command” error. Of course this is merely an inconvenience rather 
than a disaster. After any * command, the file display is updated. 


Pressing [33@N73 at any time will abandon the entire load or save process. 


CHANGING DIRECTORIES (DFS) 


The file menu only shows the filenames in the current directory. In order to observe the 
files in another directory, you could simply enter the appropriate star command, eg 


*OrR [SRE 


There is a simpler way however, and that is to use the required directory letter together 
with @g9. For instance, in order to select directory "H", just press [@QIWI%I, and the 
root ($) directory can be invoked by means of [UNUGRIGIIUET. 


USING WITH THE ADFS 


There are couple of points relating to the file menu under Acorn’s hierarchical ADFS. One 
is that any directory may contain sub-directories, which may have further sub-directories 

and so on. Directory names are shown along with the ’normal’ files, but are not visibly 
distinguishable from them. If you use one of the methods described above to select a 
directory name, then the appropriate *DIR command is given, and the file catalogue updated 
accordingly. KRUG @A will move back to the parent directory, i.e. up one level. 
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ADDITIONAL EMBEDDED COMMANDS 
Brief summary 


Two extra embedded commands have been added to WORDWISE PLUS II. One is the PD ("P"rint 
“D"ate) command. It is usually only applicable to the Master (not the Compact or Model B), 
and it will cause the current date to be printed, e.g. 


3rd March 1986 


The other command is PT, short for "Print “T"ime. Similar to the above, it extracts the 
time from the clock, eg 11:09:37 


The details... 


WORDWISE PLUS II offers the user two more embedded commands. One is PD, short for Print 
Date. It makes use of the real-time clock present in the Master, and so it will generally 
not work in a Model B. 


*TIME on the Master shows a fairly detailed display of the internal clock. By including 
the embedded command 


ii Paes 2) 


the time at that moment can be made to appear on a letter. A typical output might be 


Wed,11 Feb 1986.12:13:24 


It would be rather unusual to date a letter with such precision however. On the other hand 
it could be very useful to be able to load in a standard letter header which automatically 
accommodated changes in date. 


MP DEJ therefore examines the Master’s clock, and presents the date in a more sensible 
form. E.g. llth February 1986 


There is nothing that the user can do to alter this format. If you wanted the day of the 

week included somewhere or were adamant that a comma should appear between the month and 
the year, then you will either have to type the date separately, or write your own code to 

read the clock. OSWORD 14 (section D.3-22 of the Reference Manual part one) is available 

for this purpose, and the enhanced WORDWISE PLUS II programming language provides numerous 
string slicing functions (like MID$) for extracting the required information. 


PT also reads information from the clock, but is only concerned with the time in hours, 
minutes and seconds. For instance; 


12:32:45 


OTHER CLOCKS, AND TIME AND DATE DISC 


These embedded commands should work with clock modules designed for BBC computers other 
than the Master, but only if the associated software properly implements OSWORD 14. We can 
supply a disc which contains segment programs showing how to both read and set real time 
clocks from within WORDWISE PLUS II. Please contact us for details. 
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ADDITIONAL CTRL KEYS 


Brief summary 


All the following keys should be used from edit mode, either text or segment. Most 
are new to WORDWISE PLUS II, although occasional reference is made to existing qui 
facilities. Pressing PE3@N93 at any time will terminate the operation. 


The range of operations may seem bewildering initially. In WORDWISE PLUS II, there 
are only a few letters which don’t perform some special operation when used with 
You might be forgiven for thinking that by the time you have puzzled out which key is 
going to do what you want, it would be easier to edit in the changes ’manually’. We can 


only promise that the more you use WORDWISE PLUS II,. the quicker their use becomes second 
nature. 


followed by [GMT will present a list of all the code 


functions, other than TaCIWT) itself. 


CTRL/P Mark paragraph. 
CTRL/Z Mark word at cursor. 
Overall layout menu. 
CTRL/E Enter printer codes. 
CTRL/I Insert printer definer. 
CTRL/L Delete line. 
CTRL/G “Goto” string. Enter the string you wish to find, select the case 


sensitivity and wildcard as required, and press BYSCU3") when on the “Begin 
search” option. 


CTRL/X EXchange (Search and Replace). Enter the search and replace 


strings, wildcard and case sensitivity wanted. Also choose between Global 
or Selective changes. 


CTRL/K Keyboard setup. Set the repeat rate/delay, CAPS status etc to suit. 
CTRL/Q Look for the next string specified by [@QUIG.- 

CTRL/U Similar to | CTRL/SA but forces letters to upper case. 

CTRL/Y Similar to [QGIWB, but forces letters to lower case. 

CTRL/ Marked section menu. Select required operation and press [MaUGOU- 
CTRL/ @ Swap the character above the cursor with the one after it. 

CTRL/T From edit mode, enter the text area. 

From edit mode, enter the chosen segment. 


oO oO 
a 

x 2 
c c 
3 3 2 


The key now deletes to the right. Its effect is absolutely identical to that of 
SELIEZN, but experience has shown that it is more convenient (certainly more logical). 
It is suggested that the newcomer to WORDWISE PLUS II uses it in preference to 
LSE, and experienced users try to forget old habits! 


The details... 


keys in WORDWISE PLUS are invaluable for editing text. Thus quickly and 
easily removes an unwanted word, forces a word recount and so on. WORDWISE PLUS 


II introduces several extra [@QJY commands, all designed to assist both experienced and 
novice users to achieve whatever result is required. 
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CTRL/P 


This will put the familiar white markers around the current paragraph. As far as 
is concerned, a “paragraph” is basically the text between two carriage returns. The marked 
section may then be deleted, moved or copied elsewhere as necessary. Frequently, the 

key may be used to put in a carriage return at a suitable point, thus enabling 
to affect just the right part of your text. The marked section includes the two 
returns at the end of the paragraph. So if the marked paragraph is moved or deleted, the 
paragraphs immediately above and below it still end up being separated by one blank line. 
This is ideal for manipulating names and addresses. 


Since there can never be more than two markers present at any one time, any existing 
markers are deleted. will normally operate very quickly, but a noticeable delay 
can be introduced (depending on the size of the document) if markers have to be removed 
first. There is not really much point in setting the markers unless they are needed for 
some specific purpose. Check the top right hand corner of the edit screen to see the 
current status. Unwanted markers can be removed with [@igW@Ad. 


Single or double carriage returns 


It can be useful to change the criterion by which a “paragraph” is defined. Normally it is 
the text between two carriage returns, but it is possible to alter it to just one carriage 
return. You do this by means of [EXQ@MZG(7WZJ. This mode can be very useful when writing 
segment programs. At the development stage it is frequently convenient to move single 

lines about, so a quick method of marking the current line is called for. Just place the 
cursor on the line to be moved, press | CTRL/ PF and then manipulate the resulting marked 
section in the usual way. To restore the “double return” marking, use [EX @mcaaa@ed. 


CTRL/Z 


This marks the word above the cursor. A warning beep will be given if you try this when 
the cursor is not on a word at all. The mark word facility is not really intended as a 
step towards deleting it is much easier), but it can be a help if you want to 
move or copy it elsewhere. The "mark word” facility includes the space at the end of the 
word, which ensures that you are not left with a double space between the words either 
side of the one just moved. 


CTRL/O 


This is intended to simplify the uninspiring task of defining the way in which your 
finished document will appear. 


WORDWISE PLUS/II support a large number of the so-called embedded commands. They are used 
to control fundamental requirements such as the maximum number of characters in each line 
("Line Length"), the number of lines in each page, the position of the left margin etc. In 

all there are over forty of them, although some are fairly specialised and of less 

frequent use. It would be wise to familiarise yourself with WORDWISE’s embedded commands 
before attempting to make use of this facility. 


Pressing shows information about Page length, Line length, Indent and the like. 
Glance through the figures displayed, and make a note of the numbers associated with (say) 
the Indent and Left Margin. The “Enter codes” option should be highlighted, so press 
GSM. Control is returned to edit mode, and the user will find that all the embedded 
commands required to produce the parameters previously displayed have been entered into 
the text, one on each line. The very first one will be "EP" (Enable Paging), which is 
necessary to tell WORDWISE PLUS that the output is to be split into pages. 
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Observe that the codes were entered at the current cursor position. You may want to 
position the cursor at the top of the document initially, although setting up the document 
layout is often the very first step. 


The default numbers shown by are ones which have been found to be suitable for 
routine business letters produced on A4 size paper, and which rarely occupy more than one 
sheet. Bear in mind how easy it is to enter these codes, just followed by 


PRETURN ; 


The line underneath the “Enter codes” line is a standard page facility. Use the cursor 
down facility to move the highlight onto this option. The available choices are A4 or A5, 
and you can select one or the other by using or (uu. 


Leave it on AS’, and press [fain]. As you do so, watch carefully what happens to the 
numbers displayed beside the Page and Line length. They are changed to take account of the 
different paper size, but the new codes are not typed into the document yet. This is to 
permit further changes to be made, perhaps to allow for the fact that a condensed 

character set is going to be used. The default assumption is 10 characters per inch (cpi). 


Changing the parameters 


Different techniques are required for entering new quantities depending on exactly what is 
being changed. For instance, the procedure for altering the “Footing posn” is not the same 
as that for the “Pad char”, although it is very simple in both cases. 


The first step is always to use the or keys to move the highlight onto the 
chosen parameter. 


1) Changing numbers 


Pure numbers may be changed in two ways. The first and most obvious is just to type in the 
new value. The second, and often the quickest, is to use the and keys to 
decrease or increase the displayed value. No check is made for “silly” numbers, such as 

page lengths of 5 and footing positions of 197. Even when the codes have been entered 
however, it is always possible to use the basic WORDWISE PLUS editing techniques to change 
them. You do not have to necessarily go back to the menu each time. 


2) Changing single character quantities 


Examples of these are the “Pad char” and the "Pound sign”. They are easily changed just by 
entering the new character. Further details on their purpose can be obtained from the 

later section on embedded commands. In brief, a pad character is used to ensure that two 
or more words always appear on the finished document separated by a space. They are 
treated as a single entity however, and hence never split across two lines. The “Pound 

sign” is required because the EPSON (and compatible) printers demand that a "#" be sent to 
them in order to produce a true “£" symbol. 


3) Changing "restricted choice” parameters 
Parameters in this category include things like “Justification”. These can only be set to 


“Yes” or “No” and nothing else, hence the restricted choice. They can be cycled through 
all available possibilities (which is sometimes more than two), by using the and 


keys. 
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4) Entering "wide choice” parameters 


This is the last type of quantity that WORDWISE PLUS II offers. It is characterised by two 
inward pointing arrows, and any input from the keyboard always appears between them. The 
document heading, footing and TAB definitions can all be set up. The purpose of the 
“Other” line will be explained later, and here we are only concerned with data, entry. 


Move the highlight onto the “Header” line, and you will see the familiar flashing cursor. 
Input from the keyboard now appears in the usual manner. The key has the normal 
effect of removing the last character typed. 


The and keys will move the flashing cursor along the input line. This 
enables you to insert extra characters (there is no “overwrite” mode), or delete them. 

in conjunction with or moves the flashing cursor to the extreme 
limits of the current line. The key deletes the character above the cursor, and 
closes up the gap. has the special property of deleting the entire line. 


Information of this type is remembered by WORDWISE PLUS II. Therefore when (or 
whatever) is used later on, the previous data is displayed and may be readily edited. 


There is little more that needs to be said about the actual method of entering or altering 
characters. A few words on the “Header” etc as given by [@gQM@ZO) are called for. 


A document header can be used to ensure that each page of the text has a certain heading 
on it. You do not have to spend ages in edit mode specifically typing in the required 
information at exactly the right position. Similar comments apply to the footer. 


WORDWISE PLUS II will normally print as a footer the word "PAGE" followed by the current 
page number, suitably centralised. This assumes that paging is enabled in the first place 

of course. Sometimes you may wish to have no footer at all. In this case, then you must 

still enter a footer of some kind. This may seem odd, but the reasoning is as follows. 


When you come to the “Enter codes” stage, WORDWISE PLUS II looks at the "Footer" that has 
been entered. If it is completely blank, then no DF (Define Footer) embedded command will 
be included. At the preview or printing stage, this results in the default being used 

which, as just mentioned, is a centralised "PAGE n”. What we must therefore do is to use a 
footer which is not blank, but at the same time does not result in anything visible on 

paper. The solution is just to use a single space as the footer. Alternatively, specify an 
“illegal” footing position, such as 10 with a bottom space of only 6. 


It is possible to include the special control characters by means of the double bar. For 
example, |G (or |g) results in the green embedded command start being used. In this way, 
both headings and footings may be centralised (say), e.g. 


Header ;|GCE!WGLOSSARY 


will produce. the word GLOSSARY centrally at the top of each page. (More accurately, its 
Precise position is governed by the “Heading posn"). 


There is also the opportunity to define the TAB positions, and the default values are 10, 
20, 30 etc. You may wish to alter these to something else, in which case just enter them 
as appropriate. E.g. 


TABS 10,25,40,43 


would result in the embedded command 
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DT10,25,40,43 
being inserted. 


Finally we come to the “Other” line. Recall that the whole idea of is to provide 
an easy way of setting up the document layout. It has been found that the default values 
are suitable for many business letters, and the A4/A5 paper sizes may be readily selected 
too. 


Word-processors are used for such a wide variety of tasks that it would not be possible to 
suit every imaginable situation. The basic idea of the “Other” option is that you can load 
in your own embedded codes from a file. This concept is not new but it is surprising how 
rarely people make use of it. Fe 
Notice incidentally how the coloured highlight “wraps around” the available options. Thus 
the quickest way to move onto the “Other” line from the "Enter codes” option is to press 


the key. 


The text that you enter on the “Other” line should therefore be a filename. The user will 
notice that the default is "LAYOUT", but of course it can easily be changed as required. 


When is pressed, WORDWISE PLUS II attempts to load the given file at the cursor 
Position. It follows that all the user needs to do is to create his or her document layout 
definer and save it to disc under a suitable name, “LAYOUT” being an obvious choice. Then, 
that same name is entered on the “Other” line and it will be loaded in. 


The application of this technique extends beyond just setting up the text format. We have 
perhaps implied that only embedded codes can be imported into the document in this way. 
This is not so, and in fact any text can be loaded in. There is considerable potential 
here for building up a library of standard paragraphs, which can then be made use of to 
concoct the final result. The sole restriction is that the number of characters in each 

file cannot exceed 255. If the file is too long, then any characters over and above the 
limit will be ignored. 


This kind of facility does not offer anything that cannot be achieved by use of “Load text 
to cursor", option 4 from the main/segment menus. Apart from the limit on the length of 
the file, the difference is really one of convenience - it is very useful not to have to 
keep alternating between the edit and menu modes. 
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CTRL/E 


Modern dot matrix printers are capable of a wide variety of different effects. Near Letter 
Quality (NLQ), condensed print and so on. Daisy wheel printers usually offer’ several 
facilities too, such as underlining or double strike. Certain results are not possible for 
obvious reasons, without physically changing the wheel itself. 


Most of a printer’s abilities may well never be used. It is clear however that in a 
word-processing environment many of them will, underlining being a good example. 


The process of forcing a printer into a particular mode of operation involves sending a 
sequence of control characters to it. For this reason WORDWISE PLUS/II offers a number of 
embedded commands to make it unnecessary for the user to have to remember strange numbers. 
These include US and UE for underline start and underline end respectively. 


The use of will display a choice of ten options numbered 0 to 9. Selecting any 
one of them will result in the required embedded code being placed in the text. This 
selection process is done in one of two ways. The first is to move the highlight onto the 
effect required and then press | RETURN F The second is to press a number 0 to 9, again 
corresponding to the desired effect. 


In either case, a single code is entered into your text. This takes the form of a green 
embedded command start ({jJ), the command itself, and an embedded command stop, [j. A 
return’ is sometimes used as an alternative to the use of | £25 and ensures that if 

multiple commands are used, they do not become inadvertently split up into two lines and 
their meaning lost. This is unlikely to be a problem here, since you will most probably 
only need one or two commands on any one line. 


In essence, each option results in an OPS (Output Printer Sequence) embedded command. 
Numbers 0 to 3 however have been assigned special meanings, namely underline start/end and 
Double strike start/end. That is why US is entered in preference to OPSO. 


When WORDWISE PLUS meets the US command during printing, what it does is to send the 
correct characters to the printer to ensure that it enters the underlining mode. 
Similarly, UE will cause underlining to be turned off. 


This is all straightforward enough. The complications arise as a result of the large 

variety of printers which are currently available. The same set of control codes will 

often mean different things to different printers. The defaults used by WORDWISE PLUS/II 
are the codes used by the EPSON range of printers, since they have sold in such large 
numbers. Many advertisers boast "EPSON compatibility” for their wares, which basically 
means that the control codes needed to produce a particular effect is the same in both 
cases. 


It is not uncommon for a user to have two printers though, usually a daisy wheel for the 
“customer” copy and a dot matrix for record purposes. Thus we must find a way of ensuring 
that the same piece of text can be printed out on two different printers with the minimum 
of fuss.. 


This is made possible by means of the RPS (Redefine Printe>~Sequence) command. These are 
numbered 0 to 9, and they may all be altered from their default settings. 


As previously mentioned, printer sequence 0 is associated with underline start. In order 
to change the control codes sent to the printer in response to US, it is necessary to 
redefine the printer sequence. The default numbers in this case are 27, 45 and 1, correct 
for an EPSON type printer. 
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Suppose now that we wish to print the text on a Brother HR15. This requires the numbers 27 
and 69 to be sent to it before it will start underlining (not 27,45,1), and we achieve 
this by means of 


Gaeeso,27, oat 


Similarly, double strike end is obtained by assigning the numbers 27 and 38 to RPS4. 
Notice that there is no space between the last number and the [Sa- 


It should now be clear that to make the printer in question produce each of the 10 effects 
listed by you have to correctly define each RPS sequence. That is the precise 
purpose of the subject of the next section. 


CTRL/I 


Different printers often require different control codes to achieve the same effect, as 
detailed above. [@GJWII enables the user to download a suitable set of RPS numbers to 
make available each of the options listed by [qQgi@ag. 


By d:fault the highlight appears on the "Epson" driver, but it may be moved to any of the 
other options given. Pressing will enter the selected driver at the cursor 

position. Alternatively, just press the number associated with the driver that you want. 
Each “driver” is just a set of 10 RPS embedded commands. 


In recognition of the fact that not everyone will be using an Epson or Brother printer, 

the facility exists to load in any driver of your choice by the use of the “Other” line. A 
valid filename is expected here and when is pressed, WORDWISE PLUS II tries to 
load it at the cursor. This sort of procedure was described in more detail under the 


section, but briefly deletes the entire line, the and keys 
are operative, and [OJSWSiS and Fee AA delete characters to the left and right 
respectively. The file must not be longer than 255 characters, and any characters after 
this limit will be ignored. 


Creating the driver in the first place involves finding out the particular control 
characters needed by the printer to produce the effect in question. This in turn can only 
be achieved by trial and error, the assistance of a friend, or a lot of time spent 
ploughing through the printer manual. 


Specialised material, perhaps a scientific manual, may well require some of the more 
unusual capabilities of your printer to be invoked. Examples might be super/subscripts and 
mathematical symbols. If this is the case, then you may like to consider the use of a 
segment program to reduce the amount of awkward typing. An example program which 
illustrates this technique is supplied on the disc under the name PCODES, and is described 
later. 
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CTRL/L 


This deletes the current line of text. No markers should be set before using GgI@2¥. 
although WORDWISE PLUS II will automatically delete them if one or more markers are in 
fact set. This can add a short delay to the normally very rapid deleting process, and we 
make the point again that there is little advantage in ever having the markers set unless 
they are needed for a definite reason. will delete unwanted markers. 


does not delete past a carriage return. For example, if you position the cursor 

on the top line of a paragraph of say ten lines, and hold down, line erasure will 
cease when the end of the paragraph has been reached. This is designed as a safety 
feature, to prevent the auto-repeat effect of the keyboard from destroying far more text 
than was intended. 


If you use on a single line in a segment program, the line is deleted but the gap 
does not close up. This makes it very easy to enter a new line. If you want the blank line 


removed, the simplest way is to either press or immediately after 
CTRL/L§& 


CTRLIG 


eit activates an extremely useful “Find string” utility. It enables you to move the 
cursor from its current position to any specified character sequence. This type of 
facility is invaluable once the document length extends beyond a few pages. 


After the use of [Q@gQMZe, the only effort usually required by the user is to press QU. 
enter the string of characters that he or she wishes to find, and then press [{agUNJ. The 


familiar edit display then appears with the cursor directly underneath the first character 
of the "Goto string”. 


The cursor does not move if the string is not found. This contrasts with the FIND command 
(in the programming language) which leaves the cursor at the end of the text. 


Irrespective of whether the string is found, a short “beep” is emitted from the speaker to 
alert you to the fact that a search has taken place. ; 


Pressing 9SsUS) when on the “Begin search” option is no different to the use of FagU) 
to terminate the string itself. 


Why is it necessary to press Strictly speaking, it isn’t, but one of the features 

of QQis@eey is that it will remember the last string entered. Slight changes are then 

easily made by using the cursor, and keys. The key has the effect of 
deleting the entire line, and is much more convenient than pressing repeatedly. 


There are a number of special control characters in WORDWISE PLUS/II. These include the 
green embedded command start, the TAB character, a carriage return etc. It is possible to 
include such characters in the search string by means of the "|" symbol. Thus a return is 


denoted by |R, the TAB by |T, and embedded command start/end by |G and | W respectively. 


Lower case letters may be used if preferred. 


It has already been stated that string searches may or may not be taking into 
consideration the case of letters. Notice that the menu offers the user the 
opportunity to decide whether case sensitivity is on (Case sensitive: "Yes”) or off. 

Exactly the same facility is obtained when is used from the main menu, but the 
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ability to alter it at the same time as entering the search string itself has obvious 
advantages. The case sensitivity can be altered by moving the highlight onto it, and using 
the and [GXSREE keys to select the desired setting. 


It is particularly handy to turn the case sensitivity off when locating embedded commands, 
since the case of the letters is immaterial. Suppose that you wished to locate all CE 
(CEntralise) commands, because you suddenly decided that all centralised headings should 
be in capital letters. Since ce, cE and so on would all be equally valid, it would be 
appropriate to perform a string search with case sensitivity off. The “Goto string” in 

this case might be 


1GCE 


Finally, there is the "Wildcard". The purpose of such a character is to allow search 
Strings where the exact character sequence is unknown. Usually, there will be no need to 
change it from the default of a "#", but occasionally it may be necessary. Just move the 
highlight onto this option and enter the new character. 


CTRL/Q 


The use of [ggi@Zey at any time from edit mode will force another search for the string 
defined under [@QYWXG. It does not allow you to change the string in any way or the 
wildcard. You must invoke the M@gqM@Zej display to do that. Regge} is equivalent to the 


use of followed by [GZQUGJ. but a great deal easier when you are trying to find 
a string which happens to occur frequently throughout the text. 


As before, a short beep is given to indicate that the search has been carried out. The 


cursor does not move if the string is not found. Kegd@feg%ey will work in either the main 
text area or any segment. 


CTRL/X 


(for eXchange) is a search and replace facility. It does not achieve anything 

that cannot be done from option 5 from the main menu, but it is generally more convenient. 
In particular, it is worth noting that will function in any of the segments, 

which hitherto could not have search and replace operations performed on them (at least, 

not without writing a segment program to do it). 


The search is always carried out from the current cursor position. Little needs to be said 
about most of the options given. The requirement to enter both a search string and a 
replace string is fairly obvious. As with [@QYWXE, it is possible to control whether the 
search is case-specific and the wildcard character. Additionally however, you can select 
between a “Global” or “Selective” replacement mode. You do this by moving the highlight 
onto this option, and using or | RIGHT The safest (default) option is selective. 


The replacement procedure commences after pressing [E{S¢0IN]} whilst on the “Begin search” 
line. For selective replacement, the user will be asked to confirm each time by answering 
"Y" to the “Replace? (Y/N)" prompt. You can abandon the process by pressing —X@NJa. 


Observe that when is used, the default position of the highlight is the “Begin 
search” option. This is intended to make it easier to restart the search with identical 
parameters. Simply use followed by [GZSMQTT. As usual, the search and replace 
Strings are stored for future use, and may be readily edited with the cursor keys together 


with and 
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CTRL/K 


is available both from edit and menu modes, though not the segment menu. It is 
possible to alter the wildcard setting and case sensitivity via [QQQWZg. and the reason 

for doing do is explained more fully under CTRL/G/X. Here, we will restrict the discussion 
to the alterations which can be made to the keyboard. 


Two important parameters associated with the keyboard are the auto-repeat rate and the 
auto-repeat delay. By the former, we refer to the ability of the keyboard to produce 
multiple repetitions of a character just by holding the key down. This effect does not 
come into force immediately - there is the auto-repeat delay which must expire first. 


The normal auto-repeat rate (8) is rather slow for word-processing work. WORDWISE PLUS/II 
therefore speeds it up to 4. (Technically, 4 becomes the delay in hundredths of a second 
between successive key repetitions). 


The auto-repeat delay is not altered and remains on its default of 50, but both parameters 
can be changed. Experienced WORDWISE PLUS users can probably benefit by changing the 
repeat rate to 3, and the repeat delay to 25. Figures lower than 3 for the repeat rate are 
not recommended because of the time taken to update the screen with fresh information when 
scrolling. 


The lowest value for the repeat delay will be up to the individual to decide. 


Values less than 3/15 for the repeat rate/delay are considered by WORDWISE PLUS II to be 
unacceptable. Every time you return to the main or segment menu the settings are checked 
and, if lower than the permitted values, returned to their defaults of 4 and 50 

respectively. The only exception to this is that 0 will be accepted for the repeat delay. 

It has the effect of disabling the auto-repeat feature altogether, though this seems like 

an unusual requirement. 


Having made some general points about the keyboard repeat, we are now in a position to 
describe how to alter it. As always, the initial step is to move the highlight onto the 
parameter in question. Then, the number associated with it may be changed in two ways. One 
is just to enter the new number, not being necessary. The other is to use the 

and (RIaag keys to decrease or increase the existing value. The method you choose 
should be one of personal preference, the end result being the same. 


The last parameter relating to the keyboard is the state of the CAPS LOCK key. The normal 
setting is CAPS ON (red lamp lit), but not many documents are produced entirely in upper 
case letters. Therefore it is usually necessary to change it after switching on the 

machine and entering edit mode. At the same time however, some users prefer all their 
filenames to be stored on disc with capitals, files being saved from the menu. Clearly, it 
might be convenient to be able to define the status adopted by the CAPS LOCK key in both 
edit and menu modes. Be quite clear about the distinction between “CAPS (Edit)" and “CAPS 
(Menu)”. The “Edit” refers to the process of entering edit mode, from menu mode by 
implication. There are four different possibilities for both edit and menu CAPS settings. 


"Off". The keyboard produces lower case letters, upper case being obtained by 


together with the required key. The red lamp (LED) associated with CAPS LOCK will be 
unlit. 
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"On". The keyboard produces upper case letters, lower case only being possible by prior 
use of CAPS LOCK. The LED will be lit. 


"ShCaps”. The keyboard produces upper case letters, lower case being generated by 
and the key in question. This is the exact opposite to the “Off" condition, and may seem 
rather illogical at first. Once you get used to it however, it turns out to be 

surprisingly useful. An example of its usage might be for entering program listings, which 
often need mainly capitals (BASIC keywords), but contain a number of variables in lower 
case. Users may also find this setting convenient when entering segment programs, although 
WORDWISE PLUS II is not fussy about the case of letters in its keywords. The LED will be 
lit. 


“None”. The computer will not attempt to interfere with CAPS LOCK, and it will remain on 
the setting previously active. 


Once the highlight has been moved onto the appropriate option, the cursor or 
keys cycle through the four choices listed above. It is not necessary to press 
to bring them into effect. This happens automatically when is used to 
return control to edit mode. 


CTRL/U 


The user will no doubt have used the facility, which “toggles” the case of the 
letter above the cursor, and then moves the cursor one position to the right. By “toggle”, 
we mean that a lower case letter becomes an upper case one, and vice versa. does 
not affect characters which are not letters. 


Sometimes it may be useful to force a fairly long sequence of letters into capitals, and 
in such situations R@gqW@A0) is probably more convenient. Contrast the effect of both 
fara@ia and Benda) on this text, perhaps a subtitle in a manual. 


Fitting And Further Details 
GGGeNH will produce: FITTING aND fURTHER dETAILS 
and clearly more desirable is 


FITTING AND FURTHER DETAILS 


achieved with | CTRL/UR 
CTRLIY 


The effect of R@GiWAd is the exact opposite to that of [Qgiyay). Letters are forced to 
lower case, and other characters are not changed in any way. To some extent, this 
sequence is pre-empted by (@i3M5) and [eii3AY but in certain situations may well come 
into its own. 


Changing large amounts of text in this way would be quite slow. Our “fast sort” package 
contains a routine to perform similar tasks, but on the entire text (or just the marked 
section). There are additional facilities too. For example, you can ensure that each 
sentence starts with a capital letter. Further details are available from IFEL. 


Page-23 


Additional CTRL keys 


CTRL/M 


activates a menu that provides a choice of actions for dealing with a marked 
section of text. Markers in WORDWISE PLUS/II are inserted by the use of . When two 
markers (maximum) have been set in this way, they can be considered to enclose a piece of 
text. Some obvious courses of action may then be to; 


1) Move it elsewhere 

2) Copy it elsewhere, leaving the original intact 

3) Delete it 

4) Change your mind completely, and remove the markers 


All of these possibilities are catered for by WORDWISE PLUS II. They are respectively 
achieved by keys [j, Ej. Em CTRL/RE 


The marked section menu will not offer anything that cannot be obtained by the use of 
these keys. What it does is to present the information in a form that is 2asy to use. 
Instead of having to remember the key presses or fumble about for the function key strip, 
all of the four possibilities listed above are available directly by the use of [QgIWZq]. 
Just move the highlight onto the required choice and press [aiUgN. Confirmation (by 
pressing "Y") will be required if an attempt is made to delete more than 255 characters. 


CTRL/e@ 


A frequent typing error is that of transposing characters, as in ’cusror’. WORDWISE PLUS 
II provides an elegant remedy for this sort of situation by means of a single key. 


iRii8k7_ will swap the positions of the character immediately above the cursor with the 
one after it. In our example of the improperly spelt ’cusror’, the steps needed to correct 
it would be; 


1) Position the flashing cursor under the “s”. 


2) Press Kqgazza- 


Beware of the auto-repeat on the keyboard. If you hold down too long your text 
will become illegible very quickly indeed, although the effect is reversible just by using 
again on the same piece of text. 


CTRL/T and CTRL/fn 


It has already been said that the segment concept of WORDWISE PLUS is one of its many 
powerful features. There are basically two ways in which the ten segments may be used. 


The first of these is to hold programs written in the special programming language (WPPL). 
Such programs cahi perform a wide variety of operations on text and/or files, and a disc 
containing somé example programs is supplied with WORDWISE PLUS II. 


The second obvious way to use the segments is just to store normal text in them. Perhaps 
you are writing an article in the main text area, and you wish to make a list of special 
words or jargon which you think should be explained in a glossary. Alternatively, you 
could use the segments as a sort of notepad for jotting down ideas as they come to you. 
All the usual editing and scrolling features can be used in segments. WORDWISE PLUS II 
even allows you to do search and replace operations by means of [aaWbd. 
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From the edit mode of the main text area, the usual way of selecting a segment is to; 


1) Press to return to the menu. 

2) Option 9 then takes you to the segment menu. 

3) Use Option 5 to select the segment that you want. 
4) Press again to enter edit mode. 


This is all rather long-winded. Ideally we want a quick way of selecting the text or any 
one of the ten segments, preferably from edit mode. That is the exact purpose of 
Prem CTRL/ fn & 


The use of from the edit mode of any segment will transfer control to the text 
area. It is then possible to enter characters or scroll through the document in the usual 
way. takes you to the edit mode of the appropriate segment, from either the main 
text or another segment. For example, will move to segment 3. It is important 
not to confuse this with used on its own (which inserts a marker at the cursor 


position). Also, the effect is quite different from that of [EIAMZ@iIAE%, which causes 
the characters stored in function key 3 to be inserted into the text. 


Once into the chosen segment, you can select another segment, move back to the text, use 
[S\@ Nua to transfer control to the segment menu etc. 


There are a couple of points to notice here. Whenever you move from one segment to 
another, the cursor always moves to the top of the newly entered segment, and any markers 
in the target segment are deleted. On the other hand, the position of the cursor in the 
main text area is “remembered”, which makes it particularly easy to return to the precise 
point at which you left off. 


It is also possible to select a particular segment from the WORDWISE PLUS II menu. You do 
this by means of where n is in the range 0-9. Eg. takes you to segment 
menu 3. Use "9" from any segment menu to transfer control to the main text menu. 


CTRUH 


This displays an on-screen help facility. The cursor up/down keys may be used to select 
the option on which further details are required, and then pressed. 


Notice that in the "CTRL keys” section, four CTRL keys are shown separately. These are 
GGG. TE. and QGGTMY. They relate specifically to SpellMaster, the 
latest spelling checker from Computer Concepts. Detailed descriptions of their use can be 
found in the SpellMaster manual, and so no more will be said about them here. Suffice it 
to say that none of these four keys have any effect in WORDWISE PLUS II without 
SpellMaster fitted. 
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ADDITIONS TO WPPL 


Brief summary 


Both FIND and REPLACE are now affected by case sensitivity. Use *NOCASE or *CASE as 
appropriate in a segment program. Also *WILDCARD sets the wildcard character. The two 
commands UPPER and LOWER work like SWAP, except that they turn letters into upper and 
lower ‘case respectively. CLEAR sets all string variables to null except for F$, S$ and 

X$-Z$. PUSH and PULL can be used to move the contents of numeric variables to a safe 
place, e.g. 


PUSH A% , H% 
H%=7 
A%=9 
PULL H% , A%& 


leaves A% and H% unchanged. POKE will write either string or numeric data directly into 
memory, e.g. 


POKE &900 , "abc" 
POKE &950 , 22 


OPENUP opens a data file for random access). PRINT# and TNPUT# allow easier data file 
handling. E.g. 


PRINT# A% , TX¥*Y% , K$ 
INPUT# G% , U% , M$ 


PLF# is short for Put Line to File, and writes string data to an output file, leftmost 
character first. USR is like CALL except that the contents of the three main 6502 
registers are stored in the appropriate integer variables before control returns to 

WORDWISE PLUS II. CAC$ is a function which returns the character at the current cursor 
position, but does not move the cursor. 


There is a new form of the IF...THEN statement available. The syntax is 


IF <expr> THEN 


The statements after the IF and up to the semicolon are executed only if the <expr> is 
TRUE. See the later section on IF...THEN for further information. 


The details... 


One of the many improvements of WORDWISE PLUS/II over the older WORDWISE is the in-built 
programming language. It has become known as the WORDWISE PLUS Programming Language, and 
we will abbreviate it from this point onwards to WPPL. 


Using this language, it is possible to write programs which will perform mail-merging, 

print addresses on adhesive labels, and indeed do virtually anything else that you are 

likely to want. In essence, WPPL enables a process to be automated. Thus in the example of 
a mail-merge situation, it would be possible to produce the names and addresses of the 
proposed recipients as a file on disc. A suitable WPPL program can then take every address 
in turn and enter it into the letter. Each one can then be printed out with no further 
intervention required by the user. 
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WORDWISE PLUS II has added a number of additional commands and functions to the 
programming language. This section summarises their syntax and use. Brief examples will 
usually be given to illustrate each one. 


At this stage it is assumed that the user is reasonably familiar with the segment 
programming concept. The fundamentals are described in “Segments & segment programming”. 


As with all commands, upper or lower case letters may be used, and abbreviations are 
permitted. Thus REPEAT (say) could be written as RepEAt or REP.. 


WORDWISE PLUS II allows keywords to be semi-tokenised. Not only does this result in 
worthwhile memory savings, it also produces faster programs. For instance, !S is the token 
for PRINT. The following are therefore equivalent; 


PRINT 4+5 LS At5 
There is a program on the utilities disc to perform the tokenising process. 


When a command syntax is stated, the use of square parentheses AU indicates that the 
parameter in question is optional. 


‘%expr' indicates a numeric expression, which may include any of the available functions 
and variables. 


‘$expr' indicates a string expression, and may also contain functions. 


CHANGES TO EXISTING COMMANDS 


Before describing the additions to WPPL, there are a few points to notice concerning some 
existing keywords. Considerable effort has been put into ensuring that WPPL programs which 

the user may already have can be run under WORDWISE PLUS II, but there are a few items to 
bear in mind. 


Both FIND and REPLACE are now affected by the case sensitivity setting and the current 
wildcard. The defaults are case sensitivity on and a wildcard of "#" which is exactly the 
same as WORDWISE PLUS. It may occasionally be convenient to turn case sensitivity on and 
off from within a segment program however, and two star commands have been provided for 
this purpose 


*CASE turns case sensitivity on, and 
*NOCASE turns it off. 


*WILDCARD may be used to alter the wildcard character. *WI LDCARD on its own sets it 
to the default, which is a “#". Alternatively, it can be followed by a single 

character (the new wildcard), or a string variable. In the latter case, the first 

character of the variable will become the new wildcard. 


Examples. 
*WILDCARD ~ 
*WILDC. $ 
v$="%" 
*wildca. V$ 
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UPPER 
Syntax: UPPER [<%expr>] 


Purpose: To force letters to upper case. 


As explained in the last section, [@{qWAU} may be used from edit mode to ensure that 
letters are converted to upper case form. To achieve the same effect by means of a segment 
program the UPPER command may be used. 


The number of characters acted upon by UPPER is controlled by the optional numeric 
expression. If it is omitted completely, a default of 1 is used. The first character 

affected is the one immediately above the cursor and after completion of the command, the 
cursor is positioned on the character to the right of the last one affected. 


UPPER has no effect on non-alphabetic characters. 
Examples 

UPPER 

UPPER 6 


J#%=5 
UPPER 2*J% 


LOWER 


Syntax: LOWER [<%expr>] 
Purpose: To force letters to lower case. 


LOWER is very similar to the UPPER command. In fact, the syntax and general usage are 
identical. The obvious rudimentary difference is that LOWER will ensure that alphabetic 
characters are left in lower case form. LOWER is the segment program equivalent of 


jaii@ag in edit mode. 


Examples. 


LOWER 
LOWER 2 
K#=7 

LOWER K%-2 


CLEAR 


Syntax: CLEAR 


Purpose: To generate space in the string buffer. 


In the WPPL environment, users have just 26 integer and string variables at their 
disposal. Certain variables are set aside for particular purposes and generally should not 
be used. An example is W%, which contains the current word count. 


Each string variable in WORDWISE PLUS II (A$-Z$) can have up to 255 characters assigned to 
it. A restriction however is that the total number of characters assigned in this way may 
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not exceed 437. If you attempt any kind of string assignment when there is insufficient 
room in the buffer, a segment program will halt with a "No $ room" error. The function 
VARFREE returns the number of characters left in the string buffer. 


After running a number of different segment programs, it is all too easy for the string 
variables to collect redundant information. This in turn can result in segment programs 
producing an error at inconvenient moments. CLEAR is intended to assist in removing 
unwanted contents of string variables. 


The CLEAR command will reset most of the string variables to the null string (""). Five 
string variables are not affected however, and these are 


F$, S$, X$,. Y$,. Z$ 


F$ is used by WORDWISE PLUS to store the last filename used to save the main text. 
Similarly, S§ (WORDWISE PLUS II only) holds the name under which the last segment was 
saved. Although it would not be catastrophic if this information was lost, it may well be 
convenient to retain it. 


X$-Z$ have been granted immunity so that the user’s program has somewhere to put data that 
may be needed again, perhaps the name of an important data file, or a search string. 


As a rule, use the remaining variables for general scratch-pad purposes. As soon as you 
wish to clear them, just use the CLEAR command. 


CLEAR will normally be placed right at the start of a program. It could even be used 
“conditionally”, e.g. 


IF VARFREE<300 THEN CLEAR 


CLEAR does not in any way affect the integer variables. 


PUSH / PULL 


Syntax: PUSH <%varlist> 
PULL <%varlist> 


Purpose: To store and retrieve integer variables. 


As mentioned in the section on CLEAR, a maximum of 26 integer variables are available for 
a segment program to make use of. In fact, P% and W% have special roles and should not 
normally be used, and this reduces the number to 24. 


Segment programming is not difficult, but without proper planning it is easy to lose track 
of which variable is being used for what purpose. Essentially, PUSH allows you to save the 
value of integer variable(s). Those same variables may then be used for any other purpose 
that you wish. Finally, in order to restore the original data, the PULL command is used. 
Hence the following short program will leave the value of G% untouched. 


PUSH G% 
G%=LEN(GLT$) 
PRINT G% 
PULL G% 


PUSH dumps the value of G% (in this case) into a place in memory. It is not necessary to 
know exactly where, and is indeterminate in any case. PULL then gets that same value back 
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It is possible to put more than one variable after both PUSH and PULL. An important point 
to bear in mind however is that the last number pushed must be the first to be removed. 
This leads to a reversal of the variable list, e.g. 


PUSH G% , J% 
J%=LEN(GLT$) 
G%=ASC(K$) 

PUL weeny has 


The store used by PUSH/PULL can only accommodate 10 numbers at any one time, far more 
than is ever likely to be required. PUSH/PULL are merely convenience commands. 

Instead of wondering whether it is safe to use T% (say) as an intermediate store, you 

can just use PUSH to save it initially and then PULL at the appropriate time. The 

saves a certain amount of programming effort, as it would otherwise be necessary to 

scan through the program looking for the variable in question. If it didn’t already 

exist all well and good. It if did, then you would be left with the task of puzzling 

out whether its contents were valuable or not. 


POKE 


Syntax: POKE <address> , <expr> 
Purpose: To write numeric or string data into memory. 


POKE will write either string or numeric data into any given address. It must be used with 
the greatest care to avoid corrupting or even losing your current text. Addresses 

&900-&9FF may be used on a disc-based system, as may &AOO-&AFF. This is a fairly 
specialised command, and an example of its usage might be to place numbers into memory as 
parameters for an OSWORD call. This could save the inconvenience of loading the required 
data from disc. 


There are two main cases to consider, the first being when <expr> is numeric. E.g. 

POKE &800 , AX%*B% 

This command works out the product A%*B% and then writes the least significant byte of the 
result into address &900. The high byte is not used. Clearly, there is no point in the 


second parameter (if numeric) ever exceeding 255. 


Alternatively, <@xpr> can be a string quantity. If this is so, then the string is written 
into memory starting at the given address. Finally, a carriage return is added. Hence 


POKE &900 , "AB" 

puts &41 (ASC"A") in address &900, &42 in &901 and &OD (return) in &902. 
Further examples. 

POKE H% , GLT$ 


POKE K%-Y% , ASC(L$) 
POKE U% , Q$ 
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OPENUP 
Syntax: OPENUP <$expr> 


Purpose: To open a file for random access. 


OPENIN opens a file from which data can only be read. Similarly, OPENOUT results in an 
output file. Later versions of WORDWISE PLUS contained OPENUP as an extra keyword, but 
earlier ones did not. It enables a data file to be opened which can then be used to both 

read and write information. 


Like OPENIN and OPENOUT, OPENUP returns a channel or handle’. This should be 
assigned to an integer variable and used with keywords such as BGET# and BPUT#. E.g. 


D*%¥=OPENUP("datal") 


K*%=BGET# D% (read from the file) 
BPUT# D% , 6*L% (write to it) 
CLOSE# D% 


If the file cannot be opened, the integer variable will be assigned a value of zero. This 
is how you can find out whether a particular file already exists. 


BGET# and BPUT# are rather cumbersome for data file handling, and users may like to 
note that WORDWISE PLUS II supports both PRINT# and INPUT#. These are described in 
the next section. 


PRINT# 


Syntax: PRINT# <%var> <,expr...> 
Purpose: To simplify the storing of data in a file. 


PRINT# enables string or numeric data to be quickly and easily written to a data file 
which has been opened beforehand. The <%var> will be the file handle as produced by 
OPENOUT or OPENUP. For instance, 


M%=OPENOUT "myfile" 
PRINT# M% , 44 
PRINT# M% , A$ 
PRINT# M% , GLT$ 
CLOSE# D% 


As in BASIC, all three PRINT# statements could be combined into one; 


PRINT# M% , 44 , A$ , GLT$ 

Arithmetic expressions in WORDWISE PLUS are evaluated as integers with two byte accuracy, 
negative numbers not being permitted. When a numeric expression is saved to a data file it 
is saved thus; 


&40 
&00 
&00 
High byte of result 
Low byte of result 
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This format may seem strange, but the user may recognise it as being identical to that 
used by BASIC. (Strictly speaking, the two zero bytes would be the two high bytes of 
BASIC’s four byte accuracy). The &40 is an identifier, and is necessary so that when data 
is read back at a later date, the type of the data that follows (string or numeric) can be 
ascertained. 


When strings are written using PRINT#, the syntax used is; 


&FF 
Length of string (&00-&FF) 
Bytes of string in reverse order 


Again, this is to ensure compatibility with BASIC. The ability to use data files in WPPL 
which have been produced either partially or wholly in BASIC is an added bonus which can 
only benefit the user. 


This is a short program and dump of the resulting data file which should help to clarify 
the precise way in which data is stored. 


H%¥=OPENOUT (“FILE”) 
PRINT# H%® , &1234 , “HELLO" 
CLOSE# H% 


*DUMP FILE 


0000 40 00 00 12 34 FF 05 4F @s2:4...0 
0008 4C 4C 45 48 *xk *k *k **x LLEH.... 


INPUT# 


Syntax: INPUT# <%var> <variable...> 
Purpose: To import data from a file into a variable. 
INPUT # complements PRINT# and can considerably simplify data handling. 


The file associated with INPUT# is defined by <%var>. This holds the file handle or 
channel and will usually have been obtained by the use of OPENIN or OPENUP. 


The parameters after the file handle will be a list of string or integer variables. 
Nothing else is permitted. For instance, 


EN PU Berge SS Ge beg, HEX, VS 


The INPUT# statement takes groups of bytes from a file and places theni in the appropriate 
variable, hence assigning another value to that variable. This could also be achieved by 
the use of BGET#, but it is much slower and more long-winded. 


INPUT# carefully scrutinises the type of the data in the file being read. Hence it not 
possible to read an integer quantity into a string variable, or vice versa. Attempting to 

do so will result in a “Type mismatch” error. Recall that PRINT# places an identification 
byte in the file before the data itself, &40 for an integer and &FF for-a string. INPUT# 
makes use of these bytes to decide whether a string or a number is about'.to be read in. It 
should be clear that when data is about to be read into a variable, the file pointer 

should always be pointing either to a &40 byte or &FF. If this is not se; a “Bad ID 
message will be issued. : 
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PLF# 


Syntax: PLF# <%var> <,$expr...> 
Purpose: To write string data to a file. 


PLF# (Put Line to File) provides another means of writing string data to an output file. 
It differs from PRINT# in that the bytes which make up the string are stored in another 
form. 


Like PRINT#, the first parameter must be an integer variable which holds the channel 
associated with the data file. At least one string quantity should then follow this, e.g. 


PLF# AX , TS 
Other string expressions may be included, separating each one with a comma. 
PLF# A% , TS , GLT$S , R$+"*" 


The bytes of the string are written to the file in the normal left to right order. No 
identification byte or string length indicator is sent as there is with PRINT#. For 
example, 


PLE# BY |. “ABC” 


sends bytes &41, &42 and &43 to the appropriate file. Observe that a carriage return is 
not automatically stored, although it is easy to do so, viz. 


PLF# C% , G$+CHR$13 


PLF# should be used in preference to PRINT# if you are trying to create a file which must 
be loaded back in WORDWISE PLUS as normal text. PRINT# is not suitable because of the 
different method of data storage. 


USR 


Syntax: USR <address> 


Purpose: To execute a machine code routine and make available the contents of A, X, Y 
and P. 


USR is very similar to CALL. Thus the <address> is the address in memory of a piece of 
machine code which is to be executed. The integer variables A%, X% and Y% are loaded into 
the appropriate registers before the routine is called. Additionally, the carry flag is 

either set or cleared as defined by the least significant bit of C%. 


It is often useful to know the values of the three main 6502 registers after the code has 
executed, and this is the objective of USR. As with CALL, you will sometimes want to set 
A%, X%, Y% and C% to suitable values just prior to using USR. This step is not always 
necessary, since certain subroutines within the operating system might only need the 
accumulator (say) to be suitably primed. An example is OSBYTE 126 (acknowledge ESCAPE). 


Immediately before control is returned to the calling program, the accumulator, X register 

and Y register are respectively stored in the least significant bytes of A%, X% and Y%. 

The status register is likewise written into C%. Remember that the integer variables used 

by WORDWISE PLUS are two bytes long, and for this reason USR will store zeros in the high 
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bytes of these four variables. This makes it unnecessary to start using the AND operator 
to mask off the high byte when testing these variables. 


This program prints an asterisk if the current filing system is the DFS. It makes use of 
OSARGS with A=0 and Y=0. , 


A%=0 

Y%=0 

USR &FFDA 

IF A%=4 THEN PRINT "x" 


CALL &FFDA would not have worked properly, because CALL doesn’t store the accumulator 
back in A%. £3 


WORDWISE PLUS II uses zero page locations &00-&8F. Both CALL and USR should always 
ensure that these locations are left undisturbed on exit. 


CACS 


Syntax: CAC$ 

Purpose: A function returning the character at the cursor. 

CAC$ is a function rather than a command, and it will return the character above the 
cursor as a string. It is very similar to GCT$, the only difference being that the cursor 
does not move one position to the right. CAC$ should be used with exactly the same syntax 
as GCT$, but just bear in mind that the cursor stays where it is. This can sometimes be 
more convenient in a segment program than GCT$. 

Examples 

PRINT CAC$ 


IF CAC$="a" THEN GOTO take 
A$=CAC$+"*"+CAC$ 


NEW 


Syntax: NEW 


Purpose: To perform a hard start. 


This command will effectively re-enter WORDWISE PLUS and delete all the text and segments. 


There is no “Are you sure” type of warning given, so use with care. There would obviously 
be no point in having this command in a program, but it may occasionally be useful from 
the main menu, i.e. 


>:NEW RETURN 
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ADDITIONAL STAR COMMANDS 


From the segment or main menu, WORDWISE PLUS II recognises a number of star commands. 
These may be seen by typing 


*HELP WORDWISE 


Most of these have already been described elsewhere, but their use will be summarised here 
for ease of reference. All these star commands may be typed in a combination of upper and 
lower case letters, may be abbreviated by the use of a period, and may be prefixed by “IF” 
if clashes with other ROMs occur. 


*WORDWISE 


This is the usual method of entering WORDWISE PLUS/II. By means of the "~" symbol it is 
possible to specify the target area which should be active upon entry. You can also 

include a filename which which should be loaded. If given, the “*" symbol should be 
followed by a "T” or a number 0-9. Examples. 


*WORDWISE “t:1.FILE 
enters the text area, and attempts to load “FILE” from drive 1. 
*WORDW. JUNK 


enters WORDWISE PLUS II, and loads "JUNK" 


xWORDW. * 


enters WORDWISE PLUS II and activates the menu driven file loading utility as obtained by 


aligee@4 from the menu. 


*CASE & *NOCASE 


These commands are used to turn case sensitivity on and off respectively. The outcome of 
FIND and REPLACE commands can vary depending on the case sensitivity setting. For example, 
if case sensitivity is off (KNOCASE), then the effect of 


FIND, Ath? 


would be to locate any of "TH", “th”, "Th" or "tH". On the other hand, the same command 
with case sensitivity on would only detect the characters "th". There are also some string 
functions (described later) which can perform case (in)sensitive searches. *CASE/NOCASE 
may be used from within a segment program. 


*WILDCARD 


WORDWISE PLUS II allows virtually any character to be used as a wildcard. The opportunity 
to change it is given on a number of occasions such as and [a@GW%q. In the event 
that you wish to set it from within a program, the *WILDCARD command must be used. It 
should be followed either by the character to be used for the new wildcard, or by a string 
variable. E.g. 
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*WILDCARD & 
G$="]" 
*WILDCARD G$ 


If the string variable is more than one character long, only the first character will be 


used. If it is null, then a “#"-is used: by default. Control characters are not permitted 
as the wildcard. 


*WARNING & *NOWARNING 


In edit mode, may be used to switch between the insert and overwrite modes of text 
entry. By default, WORDWISE PLUS II issues a short beep every time a key is pressed when 
in overwrite mode. Thus an audible warning alerts you to the fact that text is being 
overwritten. 


If this beep proves to be an irritation, it may be turned off from the main menu by the 
*NOWARNING command. *WARNING turns it back on again. 


*VKEY 


*VKEY will display the contents of all the function keys 0 to 9, or just one. It does so 
in a form suitable for editing off the screen with the cursor keys in the normal way. 


*VKEY 


displays all keys, and 

*VKEY 4 

shows only function key 4 (in this case). 

If you want to edit any of the key definitions, then you must make sure that the next 


character pressed (after *VKEY) is a "*". If this is not done, the menu will re-appear and 
clear the key definitions from view in the process. 


* FKEY 


*FKEY provides a way of saving the current key definitions to a file. The keys may then be 
loaded with these definitions quickly and easily in the manner described shortly. 


*FKEY on its own will save the definitions to a file called "FNKEYS” by default. It is 
permissible to specify any other file however, such as 


*FKEY KEYDER 


These commands will create an ASCII file with all the key definitions stored in it. These 
may then be loaded into the function keys by entering from the menu, 


*EXEC KEYDEF 


Of course, use FNKEYS if the default name is applicable. A popular method of defining the 
function keys is to load a file directly into &BOO-&BFF, since this is the function key 
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buffer on a model B computer. This trick does not work on a Master however, since the 
buffer has been moved. The *EXEC method outlined above is completely ‘legal’, and will 
work in all machines. 


Exactly how does it work? As an initial step, we suggest that you return to the main menu, 
and define at least one function key. For instance, 


*KEY 4 HELLO 
Then issue *FKEY as above. This creates the required file on disc. 


Now load that same file into memory (option 2) and press to enter edit mode. 
Scroll down to the bottom of the text, and the current key definitions should be clearly 
visible as *KEY O, *KEY 1 ete. 


Notice that some additional information is given, such as the characters needed to include 
the green “embedded command start” code in a key. Even cursor movements are possible. 
Observe also how easy it is to edit the key definitions using the word-processor itself. 

It is a simple matter to “build up" key definitions by using to mark any special 
character sequences needed, and then copying them down to the *KEY lines. 


The changes that you make to the *KEY commands do not come into effect immediately, and 
* EXEC will be required as detailed later. 

You will see that every line begins with the sequence *;|, other than the *KEY commands 
themselves. This is because *;| is rather like BASIC’s REM statement. The operating system 
takes no notice of lines such as these. However, REM is particular to BASIC, whereas most 

if not all languages will provide access to star commands. 


Once any changes have been made, the file can be re-saved to disc. The final stage is to 
issue the *EXEC command, and it is this which causes the key definitions to be loaded. 

* EXEC effectively opens the named file, and then proceeds to act upon every line read in. 
These lines will include the *KEY commands, and this is how the keys come to be defined. 
The lines beginning with *; are ignored however, although they may have been useful during 
the edit stage to remind you of certain character sequences. 


There is of course another way of getting the definitions into the keys without having to 
save the file and then EXEC it back. The technique is to ensure that the definitions are 
loaded into a segment (as opposed to the text area), and then to run that same segment. 


This works because the ASCII file created by *FKEY is a valid segment program, each line 
being no more than a “star” command. Therefore when that segment is run, the effect is to 
execute each and every one of those commands. This in turn defines the keys appropriately. 


There is an example file called MYKEYS on the disc. This was produced using the *F KEY 
command, then some extra lines were added to indicate the purpose of each one. In order to 
experiment with these definitions you will either need to enter *EXEC MYKEYS from the 
menu, or load it into a segment and run it, as explained above. 


*TVERIFY and *MSVERIFY 


The purpose of these two commands is to enable the user to check that the document in 

memory has been correctly saved to disc. It does so by comparing the data in memory with 

that in a named file. *TVERIFY checks the entire text, whereas *MSVERIFY deals with a 
marked section only. The existence of these new commands makes the “VERIFY” program on the 
disc largely redundant. 
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In the discussion which follows, we will refer to the *TVERIFY command. The syntax for 
*MSVERIFY is identical, and the only difference is that *MSVERIFY checks just the marked 
section of text, not all of it. 


The filename after *TVERIFY is optional. This is because WORDWISE PLUS II “remembers” the 
last filename used for saving both the main text and the segments. If you therefore issue 
*TVERIFY on its own, the file used for checking will be the current “working” file, i.e. 

either F$ or S$. This makes it very easy to do the checking immediately after saving your 

data. For example, having saved the text under the name "MYFILE” (say), then you can just 

enter 


*TVERIFY 


and WORDWISE PLUS II will use the name MYFILE by default. 
You can of course specify a different file, e.g. 
*TVERIFY :2.PROG 


If you are using discs (but not tapes), the checking operates as follows. Initially, 
WORDWISE PLUS II compares the length of the data in memory with the length of the 
appropriate file. If the two are not the same, it reports whether the file is longer or 
shorter, and asks if you wish the comparison to proceed. After all, if the lengths differ, 
then they certainly cannot be identical. 


Assuming that the lengths are equal, the byte comparison commences. A “Pass” message is 
self-explanatory, indicating that each and every byte in the file matched the data in 
memory. 


“Fail” indicates that a byte has been read from the file which did not match the 
corresponding byte in memory. If you enter edit mode, you will find that the cursor has 
been positioned under the offending character. 


If you are using tapes, the checking will still be done. However the stage involving the 
comparison of the length of the file with the information in memory will not occur. 


If the machine has indicated that the file is either longer or shorter, then a “Pass” 

message must be interpreted with caution. All it means is that by the time the end of the 
text in memory was reached, no discrepancy was found. The file was longer than the text in 
memory. 


“Fail” has exactly the same significance as before. 
Another possible error is "EOF" (End Of File). It means that the file must have been 


shorter that the data in memory, but the checking up to the end of the file did not locate 
any problem. 


*LDATA and *SDATA 
You will be aware that WORDWISE PLUS II provides a menu via to enable the user to 


select the keyboard parameters. [@ji@fe} also provides default text layout values, which 
can of course be altered as required. 
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Many users make use of what is called a ! BOOT file. This contains a number of commands 
which automatically set the system up to meet their personal preferences. For instance, it 
is quite common to use a *FX 11 command to change the keyboard repeat delay. 


Unfortunately, *FX 11 has no lasting effect in WORDWISE PLUS II. This is because it uses 
the value which you enter via the menu for the keyboard delay, and completely 
overrides anything else. 


We have overcome this type of difficulty by providing two commands *SDATA (Save DATA) and 
*LDATA (Load DATA). *SDATA followed by a filename will save information such as the 
keyboard parameters to disc. Subsequent use of *LDATA enables the parameters to be 

retrieved again. You do not have to use the drop-down menus every time. 


As an example, suppose that you have used f@iNW@Zq@ and feaiiW@fe} to set up the machine to 
suit your requirements. Return to the menu and enter 


*SDATA AFILE 


This saves the relevant data under the name "AFILE”. To load it back again, use the 
command 


*xLDATA AFILE 


The file which you try to load in this way must be exactly &100 bytes long. If it is not, 
you will obtain a “Bad data” error. 


*LDATA can of course be included in a ! BOOT file. 


*FF and *NOFF 


These two commands are used to decide whether or not a form feed character (12, &OC) is 
sent to the printer after printing each page. The normal arrangement is that no form feed 
(FF) is sent. 


If you are using a dot matrix printer, and have managed to master the tricks needed to 
prevent output appearing on the perforations, then you may not need to use these commands. 


After a *FF (Form Feed) command, WORDWISE PLUS II will send a form feed character to the 
printer immediately prior to its "PAPER!" or "--PAGE BOUNDARY—" messages. The effect is 

to cause the printer to churn out blank lines until it reaches the start of the next page. 

All this is related to the number of lines that the printer thinks there should be on each 

page, which in turn is set by using control codes. 


Suppose that the fan-fold paper you are using has 65 lines per page. You should program 
your printer so that it too assumes 65 lines per page. This is done with ESC+C on an EPSON 
compatible printer. 


Consider now the document itself. It should be clear that unless the page length (PL 
embedded command) is set to 65 also, eventually the printed output will begin tu cross the 
paper perforations. But this is avoided with the automatic form feed. 


As a specific example, let us suppose that PL40 is used. Assuming that *FF has been 
issued, this is what happens during printing. WORDWISE PLUS II sends 40 lines to the 
printer which reproduces them on paper. It then sends a form feed, the effect of which is 
as follows. The printer is assuming 65 lines per page, but it has only received 40 so far. 
The form feed therefore causes it to output 25 (ie 65-40) blank lines, which of course 
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will take it to the start of the next physical page. Printing recommences immediately 
after the perforations. 


There are other ways of skipping the perforations of course. Adjusting the top space and 
bottom space parameters (TS and BS embedded commands) is one way, and use of the “skip 
perforation” command to the printer is another. Hopefully, the use of *FF will simplify 
things. It turns out to be very useful with some laser printers, as it ensures that the 

sheet of paper is ejected at the end of each page. 


*NOFF (NO Form Feed) reverts to the default arrangement whereby no form feed is sent. 


*PREVIEW and *NORMAL 


These commands are related to the use of from the menu. In brief, 
enables you to preview a long document in 80 column mode, which is useful if you do not 
have shadow RAM fitted. provides other features too, such as the ability to stop 
the screen from scrolling. In order to prevent the routine from trying to preview the text 

in 80 columns, but still take advantage of the facilities offered by [EXIGZJ, use the 
command *NORMAL. The opposite of this is * PREVIEW. See the section "Special Printing 
Requirements” for more information. 


*PROMPT and *NOPROMPT 


The command PREVIEW TEXT will preview the text in memory. When previewing has finished 
however, the screen immediately clears. Sometimes it would be more convenient if a “Press 
any key" message was displayed first. 


After the command *PROMPT has been entered, this is exactly what happens. You therefore 
have a chance to examine the display before pressing a key to continue. 


Equally, there are occasions when this prompt could be a hindrance. To revert to the 
default arrangement whereby no prompt is issued, use the command *NOPROMPT. 


PREVIEW TEXT is subtly different from menu option 7 in that it does not reset the document 
layout parameters to their default values. It is this feature which enables several files 

to be previewed or printed as if they were one long document. This is the basis of 

“Continuous Processing", whereby a large word-processing project is split up into several 

smaller files. 


-infkee#Leae#mt 
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Additional menu operations 


Cilmfag and Egiigggg work from both the main and segment menus, and are intended to 
simplify the process of printing and previewing parts or all of a document. "6" and "7" 
used on their own from the menu work exactly as before. 


In response to [EgIaMAy or Egiiggzg@ a small drop-down menu appears, and it offers the 
following information. We have shown in brackets the possible “settings” for each line, 
the first one being the default in each case. 


Section: (Al1l/Marked/Page) 
Start Params: (Reset/Load) 
Save Params: (NO/Yes) 
Inhibit Scroll: (No/Yes) 
Page no.: (1-65535) 


In order to alter any of the first four parameters, use the or PE) keys to move 
the highlight onto the chosen option. The and keys will then cycle through 
the available settings. 


Let us start with the “Inhibit Scroll" option, probably the easiest one to understand. 

When you preview a document, the lines of text normally rush past without giving you a 
chance to read it. Two ways to prevent this happening are to use | CTRL/SHIFT f cr the 
space bar, but this is often not very convenient. A better approach is to ensure that 
“paged mode” is engaged when the document is previewed. This means that the screen stops 
scrolling when a certain number of lines have been printed. (The use of the word “paged” 
above refers to the technique of preventing the screer. from scrolling, rather than 

splitting the document into page 1, page 2 etc). 


Various tricks have been devised to initiate this “paged mode”. One is to place a SEGn 
embedded command at the top of the text, and then to put a VDU 14 command in the 
appropriate segment. When scrolling stops, you can obtain a further screenful of lines by 
pressing fogllag briefly. The only problem with this approach is that you will usually 

want to take out the VDU 14 when you come to actually print the document, otherwise you 
will have to keep pressing all the time. 


WORDWISE PLUS II attempts to simplify all of this. From the and menus, 
just set “Inhibit scroll” to “Yes” if you want this paged mode, and to “No” if you don’t. 
Press to commence previewing or printing as the case may be. 


PARAMS 


You will notice that two of the items on the previewing menu include the word “params”. 
Before we can set these correctly, we must make sure that we understand what these PARAMS 
refer to. 


Let us imagine that you have a document in memory that is about two and a half pages long. 
When it is previewed, we would see pages 1 and 2 go by, and then, about half way through 
page 3, a “Press any key” message would appear. Any key press then clears the screen and 
displays the menu again. 


Something which may not be obvious is that WORDWISE PLUS II has remembered how far it got 
with the previewing process. Thus it knows that it was currently on page 3 (in this case), 

and that the next line should be line 34 (say). Other information is also retained, such 

as the current line and page lengths, the left margin, top and bottom space, the header 


Page-41 


Special Printing Requirements 


and footer, and more besides. Everything in fact which controls document layout. We 
collectively refer to this information as the PARAMS. 


If all this is so, why is it that when the document is previewed again, it starts at line 

1 on page 1? The answer lies in the fact that the use of "6" or "7" from the menu causes 
everything which affects the text layout ("PARAMS") to be reset to sensible default 

values. For example, the left margin is set to zero, the pad character is assumed to be a 
"|", and so on. If this was not done, you might find random values being used for line 
lengths and the like, producing some very strange results. 


In practice, the document will normally contain embedded commands to set margins, indents 

etc to whatever you wish. Thus, after WORDWISE PLUS II has reset the PARAMS, they are 
promptly altered by a bunch of embedded commands. The end result is that the document 
appearance is controlled by embedded commands entered by the user, but you should try to 
remember that WORDWISE PLUS II did in fact reset PARAMS immediately before previewing or 
printing. 


WORDWISE PLUS II also supports a PREVIEW TEXT command, the meaning of which is fairly 
self-explanatory. It differs from menu option 7 however in that'it does NOT reset PARAMS. 
PARAMS will start off with the settings which were active when the last previewing or 

printing process left off. We can illustrate this as follows. 


Load a suitable document into the main text area, one or two pages is ideal. You can use 
the file called ATEXT on the disc, supplied for this purpose. Now preview it by pressing 


"7" from the menu. 


Make a mental note of the last line number displayed and the page which was being printed. 
Now press a key to return to the menu. 


Use to go into edit mode and delete the embedded commands at the top which have 
been used to control page/line length, left margin etc. Then return to the menu. 


The next stage is to type in the command 


 PREVIewW Tower RET 


(note the colon), and then press almost immediately to halt scrolling. Notice 
that the first line number should carry on from where it left off previously. The 
page/line lengths should be the same as before, even though there are now no embedded 
commands in the document. 


To recap, we started out with a document in memory which contained various embedded 
commands. We then previewed it using menu option "7". Having deleted those embedded 
commands, we then previewed it using the PREVIEW command. It was apparent that WORDWISE 
PLUS II had remembered which line was to be printed next, what page it was on, indents, 

pad characters etc. The PARAMS were not reset. 


It only remains to preview the text now using "7" from the menu. When you do so, you will 
find that the document is not split into pages, the line length is 70, there is no left 

margin etc. This is because WORDWISE PLUS II has reset PARAMS to their defaults, and there 
are now no embedded commands to change them to anything else. 


These PARAMS are clearly very important, since they control the appearance of the finished 
document. It seems that instead of including a profusion of embedded commands in our text 
we can somehow make use of previous values. It is therefore not surprising that a way has 
been provided to save and load PARAMS to/from disc. The relevant commands are; 


Page-42 


na EHH HH ss lh CU 6M 


Special Printing Requirements 


SAVE PARAMS <file> 
LOAD. PARAMS <file> 


We could therefore preview a document, and then save the settings to any chosen file. 
Similarly, we could load PARAMS from a file just prior to previewing something. The 
usefulness of this is that it provides us with a way of splitting a large project into 
several different files. 


Very long texts 


Suppose that we are writing a report, the length of which is far too great to fit into 
memory all at once. We can circumvent the problem by splitting up the document into 
suitable sized chapters or sections, each one being a separate file. 


In the first file we put all the embedded commands required to set up the page length etc. 
We could include [JPN 19] (Page Number 1), although this would be the default 
assumption anyway. 


Having previewed this file, we might establish that the last page was, say, number 4. We 

then load the second file, put in the same embedded commands, but instead of JJJPN1—J 
we use Gen 59 (the previous file only went up to page 4). We could continue in this 

way, making sure that each file had its own set of embedded commands. 


The inherent weakness of this approach is that it is not very easy to accommodate changes. 
Suppose that we went back to the first file and added some more lines of text. Let us 
further imagine that this results in the first file going all the way up to page 6, not 

page 4 as before. This means that we must now load the second file and amend the "PN" 
embedded command to reflect this change. And the third file, the fourth... etc. 


It is possible to solve this type of problem by making use of PARAMS. In brief it works 
like this. 


1) The very first file has all the embedded commands to define line length, left 
margin and so on. 
2) This file is previewed (and edited if necessary) to ensure that the layout is to 
our satisfaction. 
3) At the end of the previewing stage, we save the PARAMS to a file. By doing so, we 


are “remembering” which line is to be printed next, what page number it is on. This 

is in addition to fundamental things like line/page length, headers and footers etc. 
4) Load the next file. This need not contain embedded commands (ECs) to set line 

lengths etc, since they have been stored in the PARAMS file. Of course, there is no 


reason why there should not be a few ECs dotted about to temporarily change the pad 


character or indent for example. 

5) Preview the text. Each time we do so, the PARAMS are loaded from the file first. 
When the layout is seen to be correct, we preview the file again (having loaded 
PARAMS of course), and finally save the PARAMS once the previewing ends. 

6) Go to step 4 if there are any more files. 


Step 5 is the important one to understand. PARAMS are loaded before previewing so that 


WORDWISE PLUS II will know that it is a third of the way through page 23 (say). We don’t 
. save PARAMS at the end until we are sure that this file’s appearance is correct. For 


example, you would probably want to avoid having a heading right at the bottom of a page 


and so some editing may be needed. The PARAMS which are saved at the end of file number 


are the ones loaded before previewing file number n+1. 
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The technique of splitting up a document into several files is known as “continuous 
processing”. We can supply a special program for doing this, which greatly simplifies the 
process of moving from one file to another. It is also possible to perform search and 
replace operations on the various files. Please ask for further details. 


80 column previewing 


One of the bug-bears of the standard model B computer is that once the text length grows 
beyond a certain size, it becomes impossible to preview it in 80 columns. Mode 7 (40 
columns) is used instead. This makes it particularly awkward to ensure that paragraphs are 
correctly indented etc. Furthermore, WORDWISE PLUS II cannot display underlined text in 
mode 7, or produce the “inverse video” effect to represent emphasised print. The only way 
to be sure that the document layout is correct is to resort to draft printouts, which are 
wasteful on paper and time-consuming. 


Computers like the BBC Master have additional memory fitted as standard ("shadow RAM"). 
This enables any length of document to be previewed in 80 column mode. 


It is possible to fit shadow RAM to a model B computer, and this will completely solve the 
problem just described. It is however fairly expensive. WORDWISE PLUS II contains a 
facility to permit long documents to be viewed in 80 columns, although there are some 
restrictions on when it may be used. One is that it will only work from the main menu, and 
another is that the complete document must be previewed (not the marked section or a 

single page). In practice, you should find this is sufficient for 99% of applications. 

After all, if you can see the entire document then you will be able to deduce where a 
marked section would be, or what a particular page looks like. 


Given that these requirements are satisfied, WORDWISE PLUS II can then preview the text. 

If memory is fairly full (i.e. such that mode 7 would normally be used), WORDWISE PLUS II 
makes temporary use of the disc drive. In essence, WORDWISE PLUS II looks at the lengths 
of the various segments and the main text. It then decides which ones should be saved to 

disc and then deleted in order to reclaim enough memory. The main text is then previewed 

in 80 columns. Finally, all the deleted segments are loaded back into memory so that when 
control returns to the menu, everything is back to normal. 


It is a good idea to have a disc available specifically for this purpose, which does not 
have many files on it. This will speed up the process of saving data to the disc, and also 
reduce the risk of a “Cat full” error. 


When WORDWISE PLUS II saves segments to disc prior to deleting them, it does so under the 
name “ZZSEGn", where n is a number 0 to 9. If the main text is also saved, it will be 
under the name “ZZTXT”. The "ZZ" prefix is fairly arbitrary, but has been used because it 
is unlikely that an identical file already exists under that name. These temporary files 

are not deleted after use. Hence if anything should go wrong during the preview process, 

you will be able to recover the situation by just loading back the required files. 


We make the point again that shadow RAM obviates all of this, since the presence of shadow 
RAM “allows any length document to be previewed in 80 columns. Thus it will never be 
necessary to start saving data to disc. : 


No attempt is made to force an 80 column screen during printing. There would be no point, 
since the layout will be correct on paper even if a mode 7 screen is being used. 


Sometimes you may not wish WORDWISE PLUS II to save material to disc in order to preview 
in 80 columns. It is possible to prevent this occurring by entering the command 
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*NORMAL 


To revert to the default arrangement, use *PREVIEW. 


Previewing a single document 


In this context, a “single” document just means that there is not supposed to be anything 
which follows on from it or precedes it. 


From the -giiggZ™@ menu, use QGaag or Gileiahg to select the “All” setting for the 
“Section:” parameter. The other choices are "Marked" and “Page”. Since we wish to preview 
the entire document, “All” is applicable. 


If you have followed and understood the discussion of the PARAMS, you should be able to 
decide for yourself whether to select “Load” or "Reset" for the "Start params”. Since this 

is the first document (probably containing its own embedded commands), there would be no 
point in loading PARAMS. Instead they should be “Reset”. (By implication, we mean reset to 
their default values, just as the normal menu option "7" would do). 


What about "Save params’? Recall that the whole purpose of saving PARAMS is to make them 
available to another file. If there isn’t another file (our assumption here), there is no 

point in saving them. So you can leave it on the default setting of “No”. You are in 

effect saying, “when previewing stops, don’t save the current PARAMS”. 


To begin the previewing process (or printing if has been used), press 
when the highlight is on any of the first four options. The “Page no.:" setting is 
completely irrelevant when the “Section: is on “All”. 


Previewing multiple documents 


Let us extend the above the case, whereby the text in memory is one of several to be 
eventually printed out. But first we want to preview it to check its appearance. 


As before, “All” would normally be selected for the section to be used. We must now decide 
whether we wish to load PARAMS before previewing, or to reset them to their default 
values. 


This in turn will depend on whether the text is the very first file. If it is, then it 

will usually contain its own embedded commands to set the final layout, and so there would 
be no need to load PARAMS before previewing. On the other hand, if another file preceded 
this one, then we would very probably wish to do so. In this way we ensure that the 
previewing of the document in memory picks up from where the previous one left off. Thus 
you would select the “Load” setting. 


Now for the "Save params:” option. Again, if you have grasped the idea of making the 
PARAMS at the end of one document available to the beginning of the next, you should be 
able to decide between “Yes” or “No” for yourself. But you must remember that we are only 
previewing at this stage. It may be that some minor changes must be made to the layout to 
prevent a table of figures (for example) from being split between two pages. 


You should therefore select the “No” setting first of all, even if there is another file 

to follow. You must repeatedly preview the text until everything is to your liking. As 
soon as this is done, change the “Save params:” setting to “Yes”, and preview once more. 
When the “Press any key” message appears, you have a final chance to back out. Press 
if you suddenly decide not to save the PARAMS. Any other key will cause the 


Page-45 


Special Printing Requirements 


PARAMS to be saved to disc under the name "ZZPRMS". 


“"ZZPRMS" is always used as the PARAMS file. Hence if you have specified that PARAMS 
are to be loaded (rather than reset) before previewing, this is the file that 

WORDWISE PLUS II will look for. It was felt that offering a choice of name would 
complicate the matter unnecessarily. Of course, with a disc system you can always use 

the *RENAME facility to keep different PARAMS files. Just make sure that the one of 
interest is renamed to "ZZPRMS”. 


An example 


At this stage we feel that a worked example may be beneficial. We will make use of two 
files on the disc supplied, ATEXT and BTEXT. The purpose of the example will be to print 
these two files as if they were just one longer file. In total, only two sheets of paper 

will be used, so it is not too wasteful. 


To begin, load ATEXT into the main text area. Go into edit mode to scan through it 
briefly, and notice that there are some embedded commands at the beginning. There is 
nothing unusual or contrived about them. 


Return to the menu, and press "7" to preview the text. This step is not strictly 
necessary, it’s just so you know roughly how this first part will turn out on paper. 


After returning to the menu, press [EXI@M@Zq. Use the cursor keys to make sure that the 
following settings are made. 


Section: All 

Start Params: Reset 

Save Params: Yes 

Inhibit Scroll: No 

Page no.: (Doesn't matter) 


Move the highlight onto any of the first four options and press [JqigN). Your printer 
should begin printing as normal. 


When the "Press any key” prompt appears, hit any key other than [E3@Nga. As you do so, 
the disc drive should come to life for a few moments. This is because the PARAMS are being 
saved to disc under the name ZZPRMS. You could confirm this by cataloguing the disc. It is 
this PARAMS file which will enable the next file to be printed correctly. 


The next stage is therefore to load the file BTEXT. Again, it won’t harm to go into edit 
mode to examine it briefly. Notice that there are no embedded commands at the start. 


Use PES@NMS to return to the menu again, and preview the document by pressing "7". You 
will see that there is no left margin, the justification is off, the line length is 70. 
Clearly, this layout would not match the previous material which is now on the printer 
paper. This is because "6" and "7" always reset the default PARAMS, and since BTEXT 
contains no embedded commands of its own, the layout too is a default one. 


Press as before, and set up the display thus; 


Section: All 

Start Params: Load 

Save Params: No 

Inhibit Scroll: No 

Page no.: (Doesn't matter) 
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The “Start params” must now be “Load”. Tunis is so that immediately prior to printing, 
PARAMS will be loaded in from the file, ZZPRMS. Recall that ZZPRMS was saved 
immediately after printing ATEXT. 


We have changed the “Save params” option.to "No". In fact, since it is the last file to be 
printed, the setting is largely immaterial. If there was a third file called CTEXT, then 

of course we would leave this on “Yes”. But if there is no file to follow on, there is no 
point in saving the PARAMS. 


The moment of truth is when you press with the highlight on one of the first four 
options. The next thing which happens is that the disc drive begins to rotate, because 
PARAMS are being loaded from the file ZZPRMS. The printer should then come to life, and 
the layout and position of the output should match what is already on paper, page breaks 

and all. 


We only used two files in this case because this was the bare minimum required to 
illustrate the point. In practice there would be no limit to the number which could be 
strung together in this way. 


Printing the marked section 


This is very straightforward to do, and you only have to select "Marked” as the setting 
for the “Section:” parameter. There are some points to be aware of however. 


1) There must obviously be two markers present. 

2) The PARAMS are always reset, and never loaded from file. Thus the setting for 
the "Start params” is irrelevant. 

3) No attempt is made to ensure that the previewing occurs in 80 column mode. 


Printing a single page 


This too is easy to achieve, and the "Section:” option should be set to “Page”. A 
fundamental requirement incidentally is that an [JE PI (Enable Paging) embedded 
command should be present in the text, otherwise it is obviously not possible to print any 
one page. 


You must also decide exactly which page you wish to preview or print. The allowable range 
is 1-65535, which should satisfy even the most prolific writer. To enter a particular 

page, first of all move the highlight onto the “Page no.:" option. Then use or 

to decrease or increase the value displayed. Alternatively, just type in the 

number required. 


The two “params” options work exactly as previously described. i.e. select “Load” if 
you want PARAMS to be loaded in from the file ZZPRMS at the start, and “Yes” if they 
should be resaved at the end. Finally, press [SQgU. 


Only complete pages can be previewed or printed, so it is sometimes necessary to put in a 


EHISP (Begin Page) command at the end of the text when you wish to view the very last 
page. 
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The use of JMP (&234) 


This is a fairly specialised topic, and a knowledge of Assembly language is helpful but 
not essential. The idea is to enable users to produce "unusual" printing requirements with 
relative ease. Examples here include; 


1) Changing the left margin on alternate pages, so as to move the margin away from 
the centre of a manual or book. 
2) Printing the page number at the bottom of a document indented to the outer margin. 


In other words, pages on the left (even numbers) would have the footer left 
justified, and the footer on the right hand pages would be moved out to the right 
margin. The "footer" is a piece of text which is printed out automatically at the 
bottom of each page. It is usually the word “PAGE” followed by the current page 
number, placed centrally in a horizontal sense. You can specify your own footer 


however. 
3) Printing (or not printing) a range of pages, such as numbers 5 to 14 inclusive. 
4) Printing (or not printing) certain pages, such as numbers 3, 5, 8, 16, 19, 23, 37 
and 52. 


The above list is not the only possible application for the technique, although they seem 
to be realistic requirements. In the last example, WORDWISE PLUS II does provide a 


PRINT PAGE command which permits only certain pages to be printed. In the case of a long 


document however (which is implied here by the fact that page 52 exists), it would clearly 
be convenient if we could simply tell the computer to list out the complete text, and have 
the printer turned on and off for us at exactly the right moment. 


We achieve special effects such as these by making use of the vector at (&234). 


Immediately after printing a "PAPER!" or "—PAGE BOUNDARY—" message, WORDWISE PLUS II 


performs an indirect jump through this vector. Normally this vector points to an RTS 
instruction, so nothing out of the ordinary appears to happen. The Assembly language 
programmer is free to intercept the vector, and perform any suitable operation. For 

example, issue the machine code equivalent of *FX5,0 to stop further output going to the 
printer. 


When the routine is entered, the variable P% contains the number of the next page to be 
printed. P% is stored at locations &440 (low byte) and &441 (high byte). Exit the routine 
with an RTS instruction. 


This whole concept has genuinely useful applications, but we are aware that not every user 
wishes to become involved in Assembly language. There just isn’t sufficient space here to 
provide the kind of detail needed to illustrate it adequately. We have a disc available 
entitled “Special Printing Requirements” which contains plenty of examples, many of which 
can be used directly. The non-technical user can therefore take advantage of them, and the 
experienced machine coder will be able to see how to extend the ideas to suit any given 
situation. Please contact us for details. 


This simple example shows an Assembly language program which stops the printer after page 
4 has been printed. 


10 FOR pass=0 TO 2 STEP 2 
20 P%=&3900 
30 [OPT pass 


40 LDA &440 \Get page about to be printed 
50 CMP #5:BNE exit NEXtE sk KO8 
60 LDX #0:JMP &FFF4 \Else do *FX5,0 


70.exit:RTS:]:NEXT pass 
8O 7?&234=8&00: ?&235=&09:REM Change vector 
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Printer Buffer 


A computer, being basically an electronic device, is capable of sending characters to 
printers at a considerable speed. Even the fastest dot matrix printer or laser printer 
would be unable to keep pace with it, and daisy wheel printers are even slower. In order 
to prevent the computer racing ahead, a special handshaking’ technique is used. 


A buffer is a block of memory that is set aside for containing characters that are waiting 
to be sent out to another device, often the printer. The BBC micro contains other buffers, 
for the keyboard amongst other things. (This is what gives you that useful “type-ahead” 
facility). The computer fills up the buffer and, at a more leisurely pace, the printer 
prints them out. In theory, when listing a fairly long document, the computer can just 
send the characters to the buffer, and let the printer get on with it. 


The problem in practice is simple. The printer buffer on the BBC is only about 60 
characters long. The buffer therefore fills up very quickly, and then everything starts 
happening rather sluggishly again. Many printers contain a buffer of their own which helps 
to some extent, but typically they are only 1K or so long. 


An ideal application for sideways (S/W) RAM is to use it as a printer buffer. Master 
owners enjoy the benefits of 4 banks of 16K S/W RAM as standard. Those users with a model 
B will need to obtain sideways RAM before they can use the printer buffer supplied. Some 


ROM expansion boards may be able to accept two 8K RAM chips, type 6264. IFEL can supply 
suitable hardware. 


The program to enable the RAM to be used as a buffer is called BUFF16, and it is a 
sideways ROM “image”. RLOAD is a program on the utility disc for loading ROM images into 
sideways RAM. So in order to load BUFF16 into your S/W RAM chip you need to type; 


*/RLOAD BUFF16 on 


wae 


where "n™ is the socket (in HEX) which contains the S/W RAM. For instance, if the RAM is 
in socket 14 then you would use 


*/RLOAD BUFFLG “6 
Of course if you have a Master, then there is the *SRLOAD command available. 


A number of additional star commands can now be used for managing the buffer. You can see 
these commands by entering 


*HELP OPTIONS 


or an abbreviation thereof (e.g. *H.OP.) This command will produce 


BUFFER 
NOBUFFER 
NOPURGE 
PURGE 


These are all ’star’ commands, which means that, for example, the computer will act upon 
such commands as 


*BUFFER (or e.g. *BUF.) and 
*NOP. 


Lower case letters are valid too, so that *buffer is acceptable. 
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The four commands BUFFER, NOBUFFER, NOPURGE and PURGE all control the way in 
which the buffer operates. 


* BUFFER 


When the computer is switched on, or when is pressed, the printer buffer defaults 
to the standard routine in the operating system. This is the one which only provides 60 or 
so characters in the buffer. 


In order to use the S/W RAM as a buffer, simply type the command *BUFFER followed by 
GEM. Output that is destined for the printer goes via this buffer. You can now list 

out a lengthy document to the printer and, as soon as the computer has ’sent’ the data to 

the buffer, the user can get on with something else. 


*NOBUFFER 


This merely replaces the new RAM based printer buffer with the operating system’s normal 
one. This is the default buffer that is used at power-on. 


* PURGE 


This command does exactly that - it clears the contents of the printer buffer. 


Why is this useful? Suppose for a moment that a long document has been sent to the buffer 
and you suddenly realise that there is a mistake near the beginning. Now, since the 

printer often contains its own internal buffer, the first move is usually to clear the 
contents of the printer (often by switching it off). Doing this, however, does not empty 

the contents of the computer’s S/W RAM buffer. The result is that the printer starts 
printing again as soon as it is switched on. 


In order to avoid this, the *PURGE command can be used. The entire contents of the buffer 
will be lost, so make quite sure that you really do want this to happen before issuing 
this command. 


*NOPURGE 


One of the effects of the key can be to purge all buffers. Clearly, this could be 
a nuisance when the buffer contains a large amount of information which hasn’t yet been 
printed. 


After *PURGE, the key will purge the printer buffer. This is in addition to 
its immediate effect of emptying the S/W RAM buffer as described above. The command 


*NOPURGE eliminates this undesirable effect of [BRQ%%¥. The *BUFFER command normally 


selects the ’no purging’ option for safety anyway, but it is wise to issue * NOPURGE 
after * PURGE has been used. 


Note: 


Do not write protect your sideways RAM when using the printer buffer. The buffer program 
will not work properly. 
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ADDITIONAL STRING FUNCTIONS 


Like BASIC, WORDWISE PLUS II includes a number of string manipulation functions such as 
MID$ and LEFT$. This section describes them in turn. Undoubtedly each one could be 
implemented using just the standard programming language, so in a sense they are simply 
convenience functions. The amount of time and effort they can save probably won’t be 
apparent until you become involved with writing segment programs. 


SOME RESTRICTIONS 


The functions may only be used as assignments, and cannot be used directly as the test in 
an UNTIL or IF statement. Hence 


X$=LEFT$(A$, 4) is valid, but 
IF LEFT$(A$,4)=H$ THEN J%=9 


is not. This limitation does not present any difficulties in practice. Instead of trying 

to test the result of the function, we just perform a direct assignment, and then test the 
result of that assignment. We could therefore split the above example involving an IF into 
two statements, viz. 


BS=LEFT$(A$, 4) Direct assignment 
IF B$=H$ THEN J%=9 Test the outcome 


No string parameter can be an ’arithmetic’ expression. Such parameters must be specified 
either by 


a) A character sequence in quotes. 
b) A string variable (A$-Z$). 


Numeric parameters should normally be specified either by a pure number in one of the four 
permitted bases, or by one of the numeric integer variables A%-Z%. The important rule is 
that absolutely no functions are allowed. It is highly unlikely that you would ever need 

to use a statement such as 


A$S=BIN$(5*LENA$+13%* (9% (ASCK$+3) ) ) 


This example would have to be split up into two statements, because the argument for BIN$ 
cannot contain functions such as LEN or ASC. The first would use WORDWISE PLUS II to 
evaluate the expression and assign it to a variable. Then we can use that same variable as 
the parameter for the BIN$ function. E.g. 


K%=5* LENA$+13* (9* (ASCK$+3) ) 
A$=BIN$(K%) 


*Complex’ arithmetic expressions such as this are not legal parameters for the string 
functions. As just mentioned, it is improbable that they would ever be needed anyway. It 
turns out to be quite convenient however to be able to perform add and subtract 
operations, and to a lesser extent, multiplication and division. All the functions will 


therefore allow you to use the +, —, * and / operators in numeric parameters. Brackets are 
legal too. E.g. 
A$=BIN$(2¥*(1+1)) A$="100" 
H$=HEX$(1+2*6) H$="D" 
Page-51 


String functions 


As with other WORDWISE PLUS II expressions, all four number bases are permitted (decimal, 


binary, octal and hex). Standard operator precedence is recognised so that, for example, 
multiplication is carried out before addition. 


WILDCARD FACILITY 


There are five functions which can take advantage of a ’wildcard facility’. These 

are DEL$, LOC, OCC, POS, and REP$. Each of these functions requires some kind of 
search to be performed on a string. Now, if you are able to specify exactly what 

the search string should be (e.g. “"XYZ"), then there is no reason why you should not do 
so. There may, however, be occasions when the exact character sequence is unknown, and for 
cases like these, it is useful to have available a character which the computer will 

assume to mean ‘any character’. 


WORDWISE PLUS II allows the user to set his or her own wildcard character for use 

with DEL$, LOC, OCC, POS and REP$. This is done via the string variable W$, which 
is simply set equal to the character that you wish to be treated as the wildcard. For 
example, to use a ’*’ as the wildcard, the following line would need to be included in 
your program. 


W$=" x ad 


All the five functions mentioned above will now use ’*’ as a wildcard until such time as 
W$ is changed. If W$ is a null string (as it is when you first enter WORDWISE PLUS/II), 
then the default character is the ’#’. If W$ is more than one character in length, then 

the first character only will be used. Note that there is no reason why W$ cannot 

be used as a string variable as normal. It only adopts its role as the wildcard 

when using DEL$, LOC, OCC, POS and REP$. 


There is one further point relating to these five functions. Recall that FIND and REPLACE 


in WORDWISE PLUS II can have case sensitivity turned on or off, on being the default. This 


can be done either from various menus (e.g. [GGWT), or by means of *CASE and 
*NOCASE. 


Since POS, OCC, LOC, DEL$ and REP$ all involve a search type of operation, it might 
likewise be useful under certain circumstances to be able to decide whether the 

search is case-specific. Therefore these functions all take into account the current case 
Sensitivity status when they are used. As an example, consider POS (which is very much 
like BASIC’s INSTR in that it tells you where one string can be found in another). 


*CASE 

A%=POS("*homeHOME", "HOME" ) A%=6 
*NOCASE 

A%=POS("*homeHOME", "HOME" ) A%=2 


All of the additional string functions on WORDWISE PLUS II may be written in either upper 


or lower case letters (or a combination thereof). They may also be abbreviated by the use 
of a period. Such abbreviations include the opening bracket. Hence 


A$=BIN$(255) could be expressed as 
A$=bin$(255) or A$=bI1.255) 
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POSSIBLE KEYWORD CLASHES 


We have already said that considerable effort has been put into ensuring that segment 

programs originally designed for use with WORDWISE PLUS will also run under WORDWISE 
PLUS II. Unfortunately, due to the large number of extra commands and functions provided by 
WORDWISE PLUS II, it is still possible for complications to arise. This section attempts to 
explain what those complications are, why they may occur, and what you can do about it. 


In essence, problems only arise when keywords are abbreviated. You will have absolutely no 
difficulties if keywords are used in full. 


Keywords are compacted to save space, and the space saving is often very significant. For 
instance, 


REPEAT becomes R. 


a saving of four bytes. When abbreviating in this way, the rule is to make sure that the 
keyword is still long enough so that it is not mistaken for something else. 


To give a specific example of the type of problem which may occur, take the 
functions STR$ and STRING$. The first of these is common to both WORDWISE PLUS and 


WORDWISE PLUS II, the second is unique to WORDWISE PLUS II. Consider the statement 
below. 


AS=STR$B% 


This particular example has been chosen because it is one which is quite possible to give 
rise to difficulties with existing programs. 


The above statement is perfectly legal. It turns the number B% into a decimal string, and 
assigns it to A$. Now, it turns out that STR$ may (usually) be shortened to eat Arson tet 
us rewrite this as 

A$=ST.B% 

We find that a "Missing ,” error occurs. Why? The reason is that “ST.” is now 

mistaken for STRING$. WORDWISE PLUS II thinks that B% is the first of two compulsory 
parameters, and it checks for the presence of a comma after it, hence the error 

message. 

Consider another case using STR$. 


IF A$=STR$B% THEN K%=1 


Again, perfectly legal and doesn’t cause any problems. If STR$ is then abbreviated in 
exactly the same way we get, 


IF A$=ST.B% THEN K%=1 

and this too works correctly. Why the difference? 

The answer lies in the rule mentioned above, namely that the new string functions may be 
used as assignments only. The last example was a test, not an assignment, and so there was 


no confusion. 


Once the cause of the problem is identified, the solution should be clear. We merely have 
to modify the offending expression to prevent it from being misinterpreted. In the case of 
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A$=ST.B% 


there would be two possible ways out. One is not to abbreviate STR$ in the first place, 
and keep it as A¢=STR$B%. After all, the saving in memory is not very dramatic. Another 
would be to place brackets around it, viz. 


A$=(ST.B%) 


This too will work correctly, although it is now longer than the original expression. 


SUM UP 


It should be clear that it is only certain sequences of characters which may give rise to 
conflicts. In our example of STR$, the use of A$ and B% was quite arbitrary, so the 
characters in question are 


$=ST. 


You need to search any existing programs very carefully for this exact character sequence. 
and subsequent use of make this process very simple. Every time it is 
found, ask yourself “is this a direct assignment?” . If so, change it in one of the 
manners described above. 


Alternatively, you can just let problems come to light when the program is run. The above 
example will cause the program to abort with a “Missing ,” error. 


Fortunately, this type of difficulty is rare. Indeed, at the time of writing, STR$ and 
STRING§ are the only known sources of trouble. 


Use of tokens 


By tokenising keywords (as opposed to merely abbreviating them), the above problems do not 
occur. This is because each keyword has a unique token, so there is never any confusion. 
Tokenised programs run faster than those with keywords written in full, and are also 
shorter. 


The easiest way to tokenise a program is to systematically replace each keyword with its 
correct token. 
Here is a simple segment program, and then its tokenised equivalent. 


DOTHIS 
A%=A%+C% EOR D% 
PRINT "x"; 
TIMES 100 


And now the tokenised form; 
1M 
A®=A®+CH !& DX 
1S "x": 
!O0 100 


Further memory savings would result from removing the spaces. 
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BINS 


Syntax: $var = BIN$(<%expr>) 
Purpose:To convert a number into its binary equivalent. 


This function takes the numeric argument and turns it into a binary string. E.g. 


C$=BIN$(1+2*3) c$="111" 
T#=5 
K$=BIN$(TH*3) K$="1111" 


Associated keywords: HEX$, OCT$ 


DELS 


Syntax: $var = DEL$(<string>,<del$>,[<start>],[<no. dels>]) 
Purpose:To delete one or more occurrences of one string within another. 


This function enables sections of string variables to be removed quickly and easily. The 
first parameter (compulsory) is the string which is to be searched and have part of it 
deleted. The second parameter, also compulsory, is the ’delete string’. In other words, it 
is the character sequence that you wish to have removed from the first parameter. The 
search carried out may or may not be case-specific. Use *CASE (is case sensitive) or 
*NOCASE from a program as required. 


Normally, only the first occurrence of the ‘delete string’ will be removed. The third and 
fourth parameters, both optional, allow you to decide:- 


1) the starting point in the first string from which the search for the delete string 
is to commence. The default value is 1, the beginning of the string. i.e. This is 
what the system assumes, unless you tell it otherwise. 


2) how many deletions are to occur. This again has a default value of 1 which is why 
only the first occurrence of the unwanted string is usually deleted. 


Examples 

A ABCs \¢"B"'s) A$="AC" 

Zz PAG ABC) BB 3) Z$="ABC AC" 

c$ C©ABAC” , """) CS="ABAC™.) “Hot foulnd. 
E$ [ RABCKA® “AN, 32) E$="AABC" 


Associated keywords: REP$, ERASE$ 


ERASES 


Syntax: $var = ERASE$(<string>,<start>,[<no. chars>]) 
Purpose:To erase a section of a string, and close up the gap. 
This function will delete characters from a string purely on the basis of position. The 


first parameter is the string of which part is to be erased. The second is the position of 
the first character to be deleted. The third parameter is optional, and controls the 
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number of characters deleted. If it is omitted, ERASE$ will delete right up to the end of 
the string. 


Examples. 

A$=ERASE$("12345678",2,3) A$="15678" 
B$=ERASE$(“hello",1,1) B$="el110" 
D$=ERASE$("TINKER",3,100) pr SESS ie ee 
L%=2 

V$="FLOPPY" 

Q$=ERASE$(V$,3,L%-1) Q$="FLPPY” 
J$=ERASE$("FRED",20,1) J$="FRED" 
A$=ERASE$("ABCDEFGHIJK", 3) A$="AB" 


Associated keywords: DEL$, REP$ 


HEXS 


Syntax: $var = HEX$(<%expr>) 
Purpose:To convert a number into its hexadecimal equivalent. 


The HEX$ function converts its argument into a hexadecimal string. Leading zeros are 
suppressed. 


Examples. 

A$=HEX$(10) A$="A" 
C$=HEX$(%11110) 6$=7 te * 
Z$=HEX$( 3245) Z$="CAD" 
V$=HEX$(0) V$="0" 
H$=HEX$( &BEEB) H$="BEEB" 
K$=HEX$(@3357) K$="6EF" 
P$=HEX$(2*(1+10) ) P$="16" 


Associated keywords: BIN$, OCT$ 


INSS$ 


Syntax: $var = INS$(<string>,<string>,<posn>) 


Purpose:To insert a sequence of characters into an existing string, at a particular 
position. 


This function provides you with a straightforward way of inserting one string into 
another. You can think of the target string as being split up into two parts, and then 
rejoined with some other string in between. 


The first parameter is the string into which we wish to insert new characters. The second 
parameter represents the character sequence to be included in the first. The final 
parameter is numeric, and is the position before which the specified characters are 
inserted. All three parameters are compulsory, and you will get a ’Missing ,’ error if you 
leave any out. 


Again, some examples will clarify the syntax. 
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A$S=INS$("123556", "abc" ,2) A$=labc23556 
H$=INS$( "THERE", "“HI",1) H$="HITHERE™ 
ES=INS$("junk","P",100) E$="junk" 
G$="123" 

Q$=INS$("abe" ,G$, 3) Qg$="ab123c" 


Associated keywords: WRT$ 


LEFTS 


Syntax: $var = LEFT$(<string>,<no. chars>) 


Purpose:To extract a specified number of characters from a string, starting from the 
extreme left. 


This function returns with a certain number of characters from the target string, always 
beginning at the extreme left. 


Examples. 

A$=LEFT$("1234567",3) A= eS" 
BS=LEFT$("abc",100) B$="abc" 
JS=LEFT$(" plastic” ,50-7%*7) J$=Sp" 
Q$="12AB34CD" 

N%=1 

Y$S=LEFT$(Q$,N%/2) Y$="12AB3" 


Associated keywords: MID$, RIGHT$ 


LHSS$ 


Syntax: $var = LHS$(<string>) 


Purpose:To remove trailing spaces from a string. 


There are many instances when the presence of trailing spaces in a string serves no useful 


purpose, and it may be preferable to remove them. LHS$ will perform this task. A string 


which consists entirely of spaces becomes a null string. 


Examples. 

A$=LHS$( "fred" ) A$="fred” 
B$=LHS$(" HH") BS="" HHS 
M$=LHS$("123 Mey M$="123" 
OS=CHSS ("x Xe) Q$="X X" 


Associated keywords: RHS$, SSP$ 
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Purpose:To locate the nth occurrence of one string within another, and return its starting 


position. 


String functions 


LOC 


no.>]) 


It can be very useful to know exactly where (if at all) a certain string can be found 
within another. In this respect LOC is rather like BASIC’s INSTR function. The 
important difference is that LOC enables you to find the second, third, ninth etc 


occurrence of the chosen 


string. 


The first parameter is the string to be searched, and the second is the search string 
itself. The third optional parameter is the particular occurrence that you wish to find, 
and has a default value of 1. Notice that the function returns a numeric rather than a 


string result. 


If the search string cannot be found, the function will return zero. Case sensitivity of 
the search can be controlled by *CASE and *NOCASE. 


Examples. 


A%=LOC("Monday" 


day") 


X%¥=LOC("1*2*3*4)","*",3) 
K%¥=LOC("ABABA", "ABA", 2) 


JIS=LOCK ReCRT, 
BS=EOC( "SP", "SP 
BX=LOC( "Bu", "BJ 


Remember that LOC makes use of W§ as its wildcard character. 


~ Grey 
"4) 
9) 


Associated keywords: OCC, POS 


Syntax: $var = 


LPAD$(<string>,<pad$>,<length>) 


LPADS 


A®=4 
X%=6 
K%=3 
J%=0 
B%=1 
B%=0 


Purpose:To build up a string to a certain length, by repeatedly adding any chosen 
character to the left hand end of that string. 


This function will repeatedly add a particular character to the left hand end of a string 
until it reaches a specified length. The resulting string can never be shorter than the 


original. 


The first parameter is the target string to be padded. The second is the pad character 
itself (often though not necessarily a space), and the third is the required length. 
Clearly, the second parameter should normally be only one character long. If it is null, 


space is used by default. 


Examples. 


A$=LPAD$("10010","0",15) 


J$=LPAD$(" abc", 


M$=LPAD$("3456" 
E$=LPAD$("19"," 


"1",5) 
nas aS 
aie, 
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A$="000000000010010" 


J$="1 “abc” 
M$="3456". 
E$=" 19" 


No change. 


=a eEaEenrReHEREHBRHeeEHtEHEtewih 


String functions 


LwWcs 


Syntax: $var = LWC$(<string>) 
Purpose:To force all letters in a string to lower case. 


This function forces all the letters in its argument into lower case. Non-alphabetic 
characters are not affected in any way. 


Examples 

AS=LWC$("ABCxyz") A$="abcxyz" 
CS$=LWC$("#$%48&()") C$="#$%48()" 
NS=LWC$("A1PHAbEt" ) N$="alphabet" 
J$S="**HILL"+" STREETH*" 

J$S=LWCS$(U$) J$="**HI11 street%*" 


Associated keywords: SWP$, UPC$ 


MEMS 
Syntax: $var = MEM$(<address>) 


Purpose:To read a sequence of characters into a string variable, beginning at any 
specified memory location. 


The MEM$ function provides you with a means of reading data directly from memory into a 
String variable. This could be useful after certain operating system calls. 


“accress> is the memory address of the first location of interest. Characters are read 
imto the given variable until either a carriage return is found, or a byte greater than 


127 is encountered. 


Examples (notice the use of POKE to place data into memory at a known place). 


POKE &900 , "bins" 

AS=MEM$(&900) A$="bins" 

POKE &950 , 65 

Bee RSS 1. 13 

¥S=MEM$ (&800+8150) V$="A" 

Syntax: $var = MID$(<string>,<start>»,[<no. chars>]) 


Purpose:To copy part of one string into another. 


MIDS can be used to obtain any subsection of a string. The first parameter is the string 
from which you wish to extract characters. The second numeric parameter (also compulsory) 
is the starting position in the string. The final parameter is optional, and determines 

how many characters are to be copied out. The default value here is such that characters 
are copied from the string until the end of that string is reached. If the third parameter 
is zero, then the function will return a null string. You will also obtain a nul! if the 
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second parameter is beyond the end of the string. 


Examples. 

A$=MID$( "DONKEY" ,4,3) A$="KEY" 
B$=MID$("addresses",3,5) B$="dress" 
K$=MID$( "PLYWOOD" ,3,0) K$ is null 
Z$=MID$("qwe",100,2) Z$ is null 
Y$=MID$("tree", 2) Y$="ree"” 


Associated keywords: LEFT$, RIGHT$ 


occ 


Syntax: “var = OCC(<string>,<sch$>,[<start>]) 


Purpose:To return the number of occurrences of a specified string within another, the 
search beginning at any chosen point in the string, or at the first character by default. 


This function will count the number of times a given search String appears in the target 

String. The starting position for the search may optionally be specified by means of the 

third parameter. As always, whether or not the search carried out is case-specific can be 
determined by the commands *CASE and *NOCASE. This is why the fourth example below can 
produce two possible results. 


Examples. 

A%=OCC("CENTRE","E") A®%=2 
B%=OCC( "HELLO", "LL") B%=1 
C%=OCC("ABRACADABRA","A",2) C#%=4 
J%=OCC("SEPTEMBER", "tem" ) J%=0 or 1 
F%=OCC("TWEEDLE DEE", "EE", 4) FR=1 
Q%=0CC("CCC", "CC" ) Qe=2 


Associated keywords: LOC, POS 


OcTSs 


Syntax: $var = OCT$(<numeric>) 


Purpose:To convert a numeric quantity into its octal equivalent, returning the result in 
string form. 


OCT$ will convert its argument into an octal string in the same way that HEX$ will produce 
a hexadecimal string. 


Examples. 

B$=OCT$(8) B$="10" 
V$=OCT$(0) v$="0" 
Q$=OCT$(%1100001) Q$="141" 
E$=OCT$(@1543) E$="1543" 
G$=OCT$(&FED7) G$="177327" 


Associated keywords: BIN$, HEX$ 
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POS 


Syntax: %¥var = POS(<string>,<sch$>,[<start>]) 


Purpose:To find the position of a specified string within another, with the optional 
facility to define a starting point for the search. 


POS is virtually identical in operation to BASIC’s INSTR function. The use of the 
keyword INSTR has been avoided however, in order to prevent possible confusion with 
the INS$ function. The latter is used to insert one string into another. 


POS will hunt through the target string and return the position of a given search string. 

It is possible to specify an optional starting position for the search to commence with 

the third parameter. You should also remember that the outcome of the search can depend on 
the current case sensitivity setting, so make sure that *CASE or *NOCASE are used as 
appropriate. 


A search for a null string will usually return an answer of 1, even if you start the 
search half way along the string. A scarch of this type however, serves no useful purpose. 


Examples. 

A%=POS("PROGRAM", "RAM" ) A%=5 
U%=POS(" POLYGON", "O") U%=2 
H%=POS("POLYGON","0O",3) H%=6 
RS=POS( “QWERT "|," 'S#3) R%=1 
V%=POS("QWE","") V%=1 
ES=POS(" ICE” "div" ) L%=0 


Associated keywords: LOC, OCC 


REPS 


Syntax: 
Svar = REP$(<string>,<sch$>,<rep$>,[<start>],[<no. reps>]) 


Pur :To replace a specified character sequence with another, starting from any point in 
pose P P q 8 yap . 
the original string, and replacing any chosen number of occurrences of the search string. 


The REPS function performs a search and replace type of operation directly on a string. 


The first parameter is the target string. The second and third parameters are the search 
and the replace strings respectively. All three are compulsory. 


The fourth parameter is optional, and can be used to specify the starting point for the 
search. The final parameter is also optional and determines the maximum number of 
replacements that will occur. Both have default values of 1, so normally only one 
replacement will take place. If you wanted all occurrences of something to be changed, 
then you could do this by making the last parameter equal to 255. 


The replace string does not have to be the same length as the search string. Case 
sensitivity for the search can be set by means of *CASE and *NOCASE. 


Examples. 


AS=REP$("ABC","B", "XX" ) A$="AXXC" 


Page-61 


String functions 


D$=REP$("“Year","ea","ou",1) DS= "Your 
K$=REP$("Sour", "ou", "ta",3) K$="Sour" 
LH=REP$("*RKKKK" UK" "+4" 2,3) L$="*K++4+4+4+4+%" 
X$=REP$( "FORTRAN", "RAN", "") X$="FORT" 
CS=REPS C" ABC’ SATS sd? dO) C$="ABC" 


Associated keywords: DEL$, ERASE$ 


RHS$ 


Syntax: $var = RHS$(<string>) 
Purpose:To remove leading spaces from a string value. 


This function removes trailing spaces from a string. If there are no leading spaces, then 
of course there is no change. A string which consists entirely of spaces produces a null. 


Examples. 

A$=RHS$(" qwe") A$="qwe" 
B$=RHS$("fred ") B$="fred 
C$=RHS$(” Cath’ See ie Cos" T2095 
Q$=" jlda #2" 

Q$=RHS$(Q$) Q$="lIda #2" 


Associated keywords: LHS$, SSP$ 


RIGHTS 


Syntax: $var = RIGHT$(<string>,<no. chars>) 
Purpose:To copy a specified number of characters out of the rightmost section of a string. 
RIGHT$ performs a similar operation to LEFT$, the only difference being that characters 


are extracted from the right hand side. The second parameter determines the number of 
characters in the result. 


Examples. 

A$=RIGHT$("Guiness",4) A$="ness" 
B$=RIGHT$("HeE110",100) B$="Hel10" 
G$=RIGHT$("ABCDEF" ,0) G$ is null 


Associated keywords: LEFT$, MID$ 


RPADS 


Syntax: $var = RPAD$(<string>,<pad$>,<length>) 


Purpose:To build up a string to a certain length by repeatedly adding any chosen character 
to the right hand end of that string. 


RPAD$ is very similar to LPAD$, and the only difference is that characters are added to 
the right hand side. The second parameter is the “pad”, and will often be a space. The 
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String functions 


last parameter determines the length of the result. 


Examples. 

AS=RPAD$("2","0",10) A$="2000000000" 
I$=RPAD$("a","",5) I$="a " 
US=RPAD$("hello","1",6) U$="hello1" 


Associated keywords: LPAD$ 


SSP$ 


Syntax: $var = SSP$(<string>) 
Purpose:To reduce all multiple spaces in a string down to single spaces. 


SSP$ is a function that falls into the same category as LHS$ and RHS$. These are all 
intended to simplify the process of removing ’unwanted’ spaces within a string. More 
specifically, SSP$ ensures that groups of two or more spaces are replaced by a single 
space. A string which consists entirely of spaces will be turned into a single space 

as might be expected. 


Examples. 

A$=SSP$(" H") A$=" H" 
BS=ssP$("") BS is null 
X$=SSP$("HELLO" ) X$="HELLO"” 
#$=sSSP$(" Good day") H$="" Good day” 
R$=" ABC XYZ _ 

RS=SSP$(R$) R$=" ABC XYZ 


Associated keywords: LHS$, RHS$ 


STRINGS 


yotax: $var = STRING$(<numeric>,<string>) 


W 


Purpese:To produce a string consisting of multiple concatenations of another. 


This function takes the second parameter and “adds” it to itself a certain number of 
times. For instance, 


fae +- 123" gives S2S2 23" 


By repeating this operation several times, it is easy to build up a string of considerable 
lemeth. The first parameter defines the number of concatenations needed. 


Exampies 

AS=STRING$(10,"%") AS="KKKKKXKKKK " 
GS=STRING$(0, "Hi there") G$ is null 
KS=STRING$(3, "ELK" ) K$="ELKELKELK" 
TS=STRING$(200, "ABC" ) "$ too long' 
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SWPS$ 


Syntax: $var = SWP$(<string>) 
Purpose: To change the case of the letters in a string. 


SWP$ will “toggle” the case of the letters in its argument. Non-alphabetic characters are 
not affected. 


Example. 
K$=SWP$("3A+*/c Ff") K$="3at*/C F" 


Associated keywords: LWC$, UPC$ 


UPCS 


Syntax: $var = UPC$(<string>) 
Purpose: To force all letters in a string to upper case. 


The opposite of LWC$, UPC$ will go through the string parameter and turn all the letters 
into capitals. Other characters are left unchanged. 


Example. 
Q$=UPC$("WE&J!Fhi") Q$="WE&I! FHI" 


Associated keywords: LWC$, SWP$ 


WRTS 


Syntax: $var = WRT$(<string>,<string>,<posn>) 
Purpose: To write a new string into an existing one, at a specified position. 


WRT$ is similar to INS$. The important difference is that WRT$ overwrites 
characters whereas INS$ splits the target string up to make room for the new 
arrival. The third parameter defines where the second parameter is to be 

inserted. The starting position cannot be greater than the length of the string given by 
the first parameter, but it is permissible for the resulting string to be longer than the 
original. 


Examples. 

A$=WRT$("FRITTER","L",2) A$="FLITTER" 
B$=WRT$( "cent", "tipede”,4) B$="centipede" 
C$=WRT$( "ABC", "XYZ" ,100) C$="ABC" 
V$=WRT$( "DRAGON", "",3) V$="DRAGON" 


Associated keywords: INS$ 
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Floating Point Maths 


If you have already used the programming language in WORDWISE PLUS II, then you will 
appreciate its usefulness. The idea of segment programming may be completely new to some 
users, but hopefully the later section on this topic will demonstrate why it is such a 

boon. 


Either way, one of the characteristics of the programming language (WWPL) is that it only 
deals with whole numbers, or integers. This means that if you try to divide 22 by 8 for 
instance, the result will be 2, and the fractional part is lost. Contrast this with BASIC, 
which can easily give the required answer of 2.75. 


The suggestion has been made in the past that the WWPL could form the basis of “quite 
a sophisticated invoice generator”. In view of the above restriction, this example is 
perhaps far from ideal. VAT calculations and percentage discounts would be tricky, and the 
largest number which WWPL can deal with is only 65535. All in all, producing a decent 
invoice generator with the standard WWPL would be an awkward programming exercise. 


For 99% of applications, the integer arithmetic of WWPL is perfectly adequate. You may be 
counting the number of addresses in a file, or finding out how many times the word 
“length” appears in the your text. In cases such as these, fractional results would 

obviously never occur. 


On the other hand, the example of a program to generate invoices does have genuine 
applications. The progamming would become much simpler if BASIC’s expression analyser 
could be used for the “number crunching” side of things. 


Using routines in the BASIC ROM has disadvantages though. For example, you need to know, 


1) where the routines are 
2) how to pass information to them 
3) how to get the results back 


There are some more subtle complications as well. If the BASIC ROM corrupts memory 
that is being used by WORDWISE PLUS II, then all or part of the current text could 
be lost. Clearly, there are traps for the unwary. 


We have produced a utility which takes care of these difficulties. It enables you to 
evaluate virtually any expression from within WWPL, including those which contain 
BASIC keywords like SQR and RND. In practice, it seems improbable that such 
facilities would be needed, but the facility is there nevertheless. With the aid of 
this program, a calculation such as 


(45. 76+12.78+15*187.24)*3/23 
giving 
373.9747826 


becomes simplicity itself to work out. It is even possible to control the number of digits 
produced, just as you can in BASIC. 


To explain it sufficient detail and provide plenty of examples requires far more space 

than is available here. You will find more information in the text file called README on 
the “Segment programs” disc. Load this file into memory, and either go into edit mode to 
read it, or print out a hard copy using menu option 6. 
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In this section some of the fundamentals of text entry and editing are described. It is 
intended to be more of a brief summary than a step by step tutorial. Bear in mind that you 
won’t damage the computer by entering invalid commands, so it never does any harm to 
experiment. For instance, if you are not quite sure what the cursor key does when 
the cursor is already at the start of a line, then the emphasis is very much on “try it 

and see”. 


Editing 


After entering WORDWISE PLUS II, the key takes you into edit mode. It is 
here that text can be typed in and changed. You don’t need to press at the 

end of a line, since new lines are started automatically. You would only use 
to deliberately force a new line, or start a new paragraph. 


The top line is a status indicator. It tells you how many words there are, and the current 
position of the cursor in the horizontal sense (it is always in the middle of the screen 
vertically speaking). You can also see the amount of free memory remaining, and whether 
you are in insert ("I") or overwrite ("O") mode. 


If you make a typing mistake, you have plenty of editing facilities to correct matters. 
The main ones are; 


Use the QU, GX. Day and ERY keys to move around the document. PETE 
rubs out the character to the left of the cursor. [@GYWZY is equivalent to Feeyyy, 
and deletes the character immediately above the cursor and closes up the gap. 


Remember that the keyboard has an auto-repeat feature, which means that holding a key down 
is equivalent to pressing it many times very quickly. Exercise care when using the 
key for example. 


esas and ReiiWaileahs respectively take the cursor to the beginning of the word 
immediately before and after the current one. [@(3W0J and RaQ] move the 
cursor in the appropriate direction by 23 lines. 


The key also plays a useful part in moving around the document. 
and respectively move the cursor to the start and end of the current 
line. In the latter case, this is not necessarily the extreme right of the screen, 

but is the end of the last word on the line. and Exes] move to the 
top and bottom of the text. 


There are a lot of other keys to perform special tasks. You can see a summary 
of them at any time by pressing followed by [GUR. Ee, removes 
any markers which are present (resulting from pressing WD. and deletes 

the word at the cursor. More details can be found in the “Additional CTRL keys” 
section. 


Normally, WORDWISE PLUS II will not split words between lines. Sometimes it can be 
preferable if it does, and so may be used to disable this on-screen 

formatting. Use of again turns it back on. An example of when it can be useful 
to have the formatting off is while using WORDWISE PLUS II to edit BASIC programs. 


The key inserts a “right arrow" character in the text. During preview or 


printing, it causes a certain number of spaces to be output, so as to move to the next 
horizontal tab position. The DT embedded command is used to control tabulation. 
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The menu 


Menu mode is reached by pressing from edit mode. Strictly speaking there are 
two types of menu (segment and text), but many of the options are common to both. Most 
are self-explanatory, and appropriate prompts given. 


1) Save entire text/segment. Saves the currently selected area, deleting any markers in 
the process. Confirmation is required if the filename specified already exists. This 
helps to guard against accidentally overwriting an important file. 


2) Load new text. This replaces the text in memory with the contents of the file that 
you specify. Again, confirmation is required to prevent careless use. 


3) Save marked section. You must have two markers set for this to work. It is very 
similar to option 1, the only difference being that the marked piece of text is saved. 
The markers, obtained by pressing from edit mode, are not deleted. 


4) Load text to cursor. This option loads a file at the current cursor position, and so 
does not delete anything in memory. Before using this option, you need to position the 
cursor appropriately from edit mode. 


5) Search and replace. This option is fully prompted, but you will probably find 
from edit mode easier to use. To search for characters such as GG} 
(green) or (white), then respectively use the sequences |T, | R, 
/G, and |W. See “Additional CTRL keys” for more information. 


From the segment menu, "5" can be used to select any of the other 9 segments. Much 
more convenient is simply to press [@{3@Jaj, where n is the chosen segment number. ie 
use PSLI827 to select segment 4. 


6) Print text. This produces a formatted document on paper. You may need to issue 
certain *FX calls to set up the correct printer port, eg serial (*FX5, 2) or parallel 
(*FX5,1). Additionally, when using the serial port, you may have to select the correct 
data transmission speeds with *FX8. 


7) Preview text. This allows you to check that your text follows the desired layout, 
without wasting paper. Whether or not the preview is in 80 column mode depends or your 
computer’s hardware, and the amount of text present. See the section "Special Printing 
Requirements”. 


8) Spool text. This can be thought of as being rather like a preview, but the output 
also goes to the file that you specify. This file will not contain any embedded 
commands, and may therefore be *TYPEd. This facility may also be useful in the area of 
electronic mail. 


9) From the segment menu, this selects the text menu, and vice versa. 
There are a number of error messages which may be issued during some of the menu 
operations. For example, the file that you are trying to load may not exist. Such messages 


are informative rather than disastrous. In this case, simply catalogue the disc and 


proceed again. 
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Function keys 


The ten red function keys all have a special purpose from within edit mode. A brief 
on-screen summary may be obtained in edit mode by pressing and then 


PRETURN 


fO Alternates between Overwrite and Insert mode. Try typing a few characters in the middle 
of an unimportant piece of text to see the difference. 


fl Embedded command start. The text after it on the same line turns green. See the embedded 
command section for more information. 


f2 Embedded command end. See the embedded command section for more information. 


f3 Inserts a white marker. When two markers have been inserted, all the text after the 
first one and before the last one is said to be “marked”. You cannot have more than two 
markers set at any time. 


f4 Moves the cursor to any chosen character. You can move to the “special” characters by 
pressing immediately followed by (say). This takes the cursor to the next 
embedded command start. 


f5 Performs a word count from the current cursor position, up to the first occurrence of 
the character that you enter. Use M@sNWA] to recover the total word count for the 
document. 


f6 Deletes from the current cursor position, up to the first occurrence of the character 
that you enter. 


f7 Deletes the marked section of text. 

f8 Move the marked section of text to the cursor position. 

f9 Copy the marked section of text to the cursor position. 

When text is being deleted, confirmation will be asked for if a large amount of text is 
involved. and [ff also have restrictions, mainly in terms of the cursor position. If 


the cursor is actually in the marked section, then | £8 | produces an error. This is because 
you are trying to move the marked text within itself. 


Eila@ can also be used with the function keys. Pressing causes the program in 
segment number n to be run. This works from both the menu and edit modes . 


The 10 function keys can be programmed by the user with useful words or phrases, and this 


can cut down on repetitive typing. You program them from the menu with the *KEY command, 
so for example 


*KEY 4 WORDWISE 


From edit mode, you can now get the characters inserted in your text by pressing 
EMeGWIZ). This technique applies to all the red function keys numbered 0 to 9. 


To include special characters in the key definition, such as [Jj or you must use 
the character sequences below. 
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cf! means il means TAB 


means 1M means 
Embedded commands 


In order to make your finished document appear as required, it is necessary to place 
embedded commands in the text. An example is LM, which stands for Left Margin. To 
distinguish these commands from the rest of the text they are preceded by a special 
marker, obtained by pressing Gi. This causes the embedded command to appear in green, 
and helps to make it stand out. Embedded commands are terminated with or | RETURN 


Some commands consist only of letters, other require numbers after them. If you wish to 
set the page length for example, then clearly the actual number of lines in the page must 
be specified. 


You can string several embedded commands together on one line. In this case or 
is only required at the end of the last one. For example to enable paging (EP), 
and set the page length (PL) to 60 and left margin (LM) to 10 you could use; 


Me > os oD 


It is important to realise that in this instance signals the end of one or more 
embedded commands. It does not generate a new line. It would have done however, if an 
had been placed immediately before the [SIGN]. This is because would mark the end 

of the embedded commands, and the would then produce a line feed as normal. 


Embedded commands must not go beyond the length of a line, or they will not work properly. 
You may therefore be forced to insert a and start another line when stringing 
several together like those above. 


As mentioned previously, you cannot damage the computer by entering incorrect embedded 
commands. It is always worth experimenting if you are not sure of the effect of a 


particular command. Remember that you need to preview the document (menu option 7) before 
the effect of embedded commands can be seer. 


Many of the available embedded commands will not be needed at first, so do not be 
discouraged by them. LM to set the left margin is a useful one, as is CE to centralise 
text. Incidentally, centralising is a function of the left margin and the current line 
lemgth. This is one feature which distinguishes the left margin (LM) from an indent 
IN), which sometimes appear to do the same thing. 


TI gives a temporary indent, and is useful for indenting the start of a paragraph. You 
cowld even program a function key as a “start new paragraph” key. Eg, from the menu enter; 


KEY O IM;M;)!!TI9{1" RETURN 

The definition is effectively two carriage returns, an embedded command start, the command 
TIS, and an embedded command end. Now simply use Eg @@i@CIWit) cach time you wish to 
Start another paragraph. 


A final point is that embedded commands can be in upper or lower case letters, or a 
mixture of both. The following are therefore equivalent; 


eso oo and) =p 150my 
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*COMMAND 


You can execute any * command by emb-dding a suitable line in the text. However, this may 
upset the printed output because WORDWISE PLUS II has no way of knowing the precise effect 
of the command. 


Examples: [J*HEL PE Ma*xtTyPe FIvegg 


BP Begin page 
This forces the computer to start a new page, but only if paging is enabled by means of 


EP. When ending a document, do not put a or after BP, otherwise the heading 
on the next page will be printed. 


BS Bottom Space. Range 0-50, default 6 


When paging is enabled, normally a certain number of blank lines occur at the end of each 
page. These are included in the total page length. By default the page length is 66, and 
the top/bottom spaces both equal to 6. This means that there are only 66-12=54 lines of 
text per page. 


Examples: [jjssof cs 7 


CE centralise n lines. Range 1-200, default 1 


This command centralises text horizontally on the page. The position is a function of the 
current left margin and line length. You can centralise several lines, but each one should 


be terminated by a [QSQY. Eg 


Mic: siRe ad EN 
steady aR 
BS RETURN 


The number may be left out, and gives a default of 1. To centralise text and underline it, 
include a space between CE and US, viz; 


Mice GMusBrel 1 ofurw 


Cl Cancel Indent 


This cancels the effect of an IN command, and subsequent printing starts from the left 
margin. It is the same as setting the indent to zero with [Jj Nog. 


Example. [JCI 


CO Continuous Output 
This is the opposite of enable paging (EP). After CO the document will not be split into 
pages, and various related commands (Define Header, Top Space etc) will not have any 


effect. 


Example. Qjcof@ 
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CP Conditional Page. Range 0-page length 


If a table of figures (say) appears in your text, and you do not want it to be split 
across two pages, then use CP. It forces a new page if there are insufficient lines left 
om the current one. For instance Gicrisg would begin a new page if there were less 
than 15 lines free on the present one. 


Examples. ijce 4 Gicrsxf 


DE Double strike End 


Cancels the effect of DS, double strike start. DE sends control codes to the printer, 
normally 27,72 or ESC+H. To make this work with printers which do not use EPSON codes, you 
will need to use the RPS3 embedded command to alter the codes sent out by DE. 


Example. (Joc 


DF Define Footer 


At the end of each page, you can have a particular piece of text printed. By default, this 
is the word PAGE followed by the page number, suitably centralised. This is because the 
footer is normally; 


Go Gic*escee ria 


The footing position is controlled by FP. 


Example. (OF BlcePAddendumfg 
DH Define Header 


This is very similar to the DF embedded command, except that it is printed in the top 
space. Specifically, it is placed at the header position, HP. As with DF, you can use the 
print page (PP) confmand to include the actual page number automatically. 


Example. Q@JoxfMjcefMchapter 1 Page-fjeryy 


DM pisable Messages 


When paging is enabled, the DM command means that the computer does not halt at the end of 
each page. This is usually ideal for continuous fan-fold paper. The opposite of this 
command is EM, enable messages. 


Example. Gove 


DP Define Pound. Range 0-255, default 96. 


Whenever 2 “£™ sign occurs in your text, the computer will actually send a different 
character to the printer. The character that it sends is controlled by the DP 
command. In order to get a true "£" on paper, you will usually need to use 
GS SEB. and to select the UK character set on your printer with 

Ges 2” . 3B. These codes apply to EPSON printers. 
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Example. JOP 359§Jes"rR", 3 


DS Double strike Start 


This command causes the computer to output codes 27,71 or ESC+G. This puts an EPSON type 
printer into double strike mode, making each character darker. Cancel the effect with DE. 
Use the RPS2 command to alter the codes generated by DS from the default. 


Example. [@JOSfHe1 1 ofc 
DT Define Tabs. Range 0-180, default 10,20... 


The key puts a “right arrow” in your text. During printing or previewing, it causes 
a certain number of spaces to be output, so as to line up with the next tab position. It 
is useful for producing columns, eg 


| TAB BY TAB PCRS) TAB Ky 


in your text usually prints as 

1 23456 3 
Use DT to alter the actual column positions. DT often does not work properly with 
proportional spacing selected (if your printer offers it). You will need to use ESC+D 


(EPSON codes) to set the tabs on the printer, and then put [§JOC9[Zq in the text in 
order to send the tab code. 


Example. M§J0T10,25,c%, ux 


EM Enable Messages 


If your printer only accepts single sheets of paper, you need to make the computer halt at 
the end of each page. Include the EM command to do this. The computer prints a "PAPER!" 
message, insert a new sheet of paper, and simply press a key to resume printing. 


Example. JJemig 


EP Enable Paging 


This tells the computer to split the document into pages. Ii is a fundamental requirement 
if certain other commands are to be meaningful. Examples include page length, top and 
bottom spaces, headers and footers. The opposite is CO, continuous output. 


Example. JJerig 


ES Escape Sequence 

Most printers require a special "escape" code in order to initiate certain effects, such 

as italics or double width characters. This involves sending code 27 followed by an 
appropriate stream of numbers. ES simplifies this by sending the 27 automatically, and the 
user only has to provide the extra information needed, separating each one by a comma. Eg 


HMeEs"b",10,%1111, &20, of 
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sets the tabs on an EPSON printer to 10, 15 and 32 (decimal). Notice that each parameter 
can be given in various ways, eg by a character or as a number. 


Example. QJes"T",@55,E%,"D",&23, 99 


Fl Fully Indent 


This command pushes a line of text up to the right hand margin, this being defined by the 
current left margin and the line length. An FI applies to a single line, so several FI’s 
may be needed to indent an address. 


Example. 


Gi i1GBeicht hance 
ape £2 Eager RETURN] 


FP Footing position. Range 0-Bottom space, default 3 


Assuming paging is enabled and a footer defined, the computer will print out the footer at 
the end of each page. Its position is governed by the FP command, and is normally 3 lines 
from the end of the page. A useful trick to prevent the footer being printed is to specify 
em “illegal” position, such as FP10 when the bottom space (BS) is only 6 lines. 


Examples. Ges 3 Grerx 


GF Get File 


Thess command causes the computer to look for the named file, and send the data in it to 

the printer. This can be useful for complex printer control sequences. Notice that the 

Sie cowld contain ordinary text, but this will upset the formatted output. This is 

because the true print position will no longer be the same as the position assumed by 
WORDWISE PLUS II. For printing extra text files from within a document, use the PF (print 
file) command. 


Examples. Gijcr ssf GicF "copes "@ 


HP Heading Position. Range 0-Top space, default 3 
Somiler im concept to the footing position, HP defines where the header appears on each 


pees. Usually it is 3 lines from the top of the page, but it can be altered to suit with 
te “> command. Remember that paging must be enabled first with EP. 


Exa=pies. | £1 leg £2] Gy PT xf 


IN indent. Range 0-line length less 10, default 0. 
IN imdents all lines from the left margin by the the given amount. IN is subtly different 


from LM. Centralising using CE is a function of the left margin and line length, and not 
of the indent. To cancel the indent, either set it to 0 or use CI. 


Examples. QJINS—Q (INHxey 
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JO Justification On 


This command causes text to be printed with a straight right hand margin. It is achieved 
by inserting extra spaces between the words in each line. This may not work properly with 
a proportional font, but many modern printers contain their own justifying facilities. 
Cancel JO with NJ (no justification). 


Example. Jjvof 


LL Line Length. Range 10-180, default 70. 


This command defines the maximum number of characters per line, in addition to the left 
margin. If the left margin was 10 and the line length 60, this means that 10 spaces are 
printed at the start of each line, and then 60 characters (max) per line. If double width 
characters are selected, then you may need to reduce LL in order to allow for the larger 
character size. 


Examples. (JLL5 79 (LL kx 


LM Left Margin. Range 0-150, default 0. 


At the start of every line, a certain number of spaces are printed out before the text 
itself. The precise number of spaces is set with LM. The effect is to indent the entire 
document. The right margin is determined by the left margin and line length, and the 
position of centralised text is also related to the left margin setting. 


When using a variety of fonts in a document, you can sometimes end up with a left margin 
that is not straight. This seems curious until you realise that the actual width of a 


space depends on the currently selected font. The solution is to use LMO in the text, and 
to set the margin on the printer instead. On EPSON printers this is done with ESC+1. 


Examples. (JLM10—%]  (j-mMsexiy 
LNE Line Number End 


This command turns off the line numbering facility. LNS turns it on. 


Example. (JUNE 
LNS Line Number Start 


Assuming that paging is enabled (EP), LNS causes the line number to be printed out at the 
start of each line, and is useful in various circumstances. The numbers do not appear on 
Paper, only on the screen during preview. Sometimes the presence of the line numbers 
upsets the screen layout, because of the extra characters that must be fitted in. You can 

turn off the line numbering with LNE. 


Optionally, LNS can be followed by a number. This fools the computer into thinking that 
part of a page has already been printed, as in the second example below. 


Examples. (JLNSM (LNssof@™ 


Page-74 


Embedded commands 


LS Line Spacing. Range 1-50, default 1. 


Using this command it is possible to produce extra blank lines between each line of 

text. This is useful for draft copies of documents which require proof reading. The 
machine normally assumes a setting of LS1, but changing this to LS2 will generate an 
additional blank line. In general, LSn creates n—1 extra blank lines. The command SS 
means single spacing, and has the same effect as LS1. The extra lines produced by LS 
contribute to the total page length. 


Examples. .s2 isvx 


NJ No Justification 


This is the opposite of JO. JO makes the computer insert extra spaces between words on a 
lime, so that the right hand margin is straight. NJ turns off this facility, thus giving 
the text an uneven, though not necessarily unsightly, right edge. 


Example. GN 


oc Output Code 


Usimg OC you can send any code or codes to the printer. A common one is OC15, which puts 
zn EPSON printer into condensed printing mode. Several numbers may be sent in the same OC 
command by separating them with commas, as in the examples below. Many printer commands 
are the special ESC variety, and the embedded command ES is then simpler, because it sends 
the 27 automatically. The first OC example below is equivalent to ES"R", 2. 


Examples. ffjoc27,82,2— ([Mjocg,9,15,0x 


OPS Output Printer Sequence 


If you frequently have to send several codes to the printer in order to achieve some 
particular effect, then the OC command could be rather unwieldy. This problem is solved by 
the presence of ten special printer sequences, numbered 0 to 9. All may be set up with any 
codes using the RPS command. In fact, four of them (0-3) are primed as follows; 


OoPSO Underline Start 2 Poy Li 
orsi Underline End 27 ,48,/0 
OPSs2 Double strike Start a ree 
orss Double strike End Are 2 


For example, when you use US in your text, the computer looks up the codes stored in 
sequence number 0, and sends them to the printer. Hence the printer (EPSON compatible) 
starts underlining. The printer sequences are not affected by the DEFAULTS command. 


Examples. Foessfm  ™jorsxxf@ 


os Operating System call 


This is very similar to a “star” command. For instance, when used as embedded commands, 
HELP and OS"HELP”™ have an identical effect. As you can see, the main difference is that 
the bit after the OS is a string. As with the star version, if any text is printed out as 

2 result of the operating system call, then it will spoil the formatting of the document. 
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This is because WORDWISE PLUS II cannot tell how much text (if any) has been produced. You 
should be able to use the preview option to assess this, and add extra embedded commands 
to compensate. 


Examples. JOSASH Gos"HELP"f@ 
PA Pause 


In contrast to dot matrix or laser printers, the only way to change letter styles on a 
daisy-wheel printer is to physically change the wheel. This is made possible by the PA 
command. When the computer encounters PA during printing, it halts and makes a beep. You 
can then change the wheel or adjust the paper position etc. Press any key to start 

printing again (not | BREAK) 


Example. jPAgg 


PC pad Character. Default CHR$(124) 


A pad character is used to prevent two or more words from being split between two lines. 
Words joined by pad characters are treated as a single long one, although the pad is 

printed as a space. The pad character is a "|" by default (just below and to the right of 
the key), but it can be altered with PC. Unlike WORDWISE, the new pad character 
must be given in quotes, or a string variable specified. In the latter case, the pad is 

the first character of the string. 


Examples. jPc’* "J mec.s 


PF print File 


PF allows text to be imported from a file during printing or previewing. It differs from 
GF (get file) in that all formatting commands in the file are obeyed, and the computer 
will keep track of the number of lines printed as a result of PF. You could use this 
facility to produce standard letters, by printing predefined paragraphs at the right 
moment. A file which is being PF’d cannot itself PF another file. PF always starts 
printing on a new line. 


Examples. [PF KS Ey Ger "prices" 


PL Page Length. Range 10-200, default 66 


If EP has been used to enable paging, this command determines the number of lines in each 
page. This includes the top and bottom spaces (TS/BS), which are both 6 by default. Hence 

the number of lines of actual text on each page is PL-(BS+TS), 54 by default. You may wish 
to vary the page length depending on the type of paper in use, and also the line feed 

pitch on the printer (often programmable with ESC codes). 


Examples. JjPLsof (jr. txf 


PN Page Number. Range 0-65535, default 1 


Whenever a document is printed or previewed from the menu, the computer assumes that the 
first page is number 1. Clearly, this might not be correct if you are printing out a large 
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document in several stages. The PN command is used to tell the computer that pages are to 
be numbered from the value given. The variable P% holds a copy of the current page number, 
and is updated as each page is printed. 


Examples. QJPn382— (enex™ 


PP print Page number 


PP is a way of getting the computer to print out the current page number. It would be 
usual to include it in the footer so that each page was correctly numbered at the bottom. 
PP can go anywhere in the document however. See the DF command for the default footer. 


Example. (geri 


PS print String 


PS must be followed by a string expression. This either means a sequence of characters in 
quotes, or (more usefully) a string variable A$-Z$. When printing, the characters are 
included in the text, with due consideration for the current line length etc. This 

technique is used in the MAIL program (mail-merge) on the utility disc. The idea is to 
chop up mames and addresses, and assign the different parts to various string variables. 

The main text has PS commands which cause the appropriate data to appear during printing. 


Examples. JJJPSCS$+STRSKx (MPsase®™ 


RPS Redefine Print Sequence 


When the OPS command is used (see earlier), the computer outputs the sequence of codes 
associated with that OPS, each one being given a number between 0 and 9. Hence an OPS may 
Se used imstead of a profusion of numbers after an OC command. You define each sequence 

wsimg RPS. The first four (0-3) are made use of by the commands US, UE, DS and DE. See the 
section on OPS for the default codes used. These codes will only produce the desired 


effect om printers which are EPSON compatible. The command DEFAULTS does not affect the 
RPS settings. 


As an example, to make a Brother HR15 daisy wheel printer start double striking, you must 
sead ESC+F. The DS command will only work if RPS2 has been used to override the default 


settimgs. The first example below shows what would be required. 


Examples. QJRPS2,27,"F'B BRes7,8%,27,45,1,9%@ 


SEG run SEGment. Range 0-9 


This command causes the program in the named segment to be executed. There is more detail 
om segment programming in a later section. 


Examples. QJscc+fg@ [secux® 


SP sPaces. Range 0-200 


This command causes the specified number of blank lines to be printed out, in the vertical 
semse. The lines contribute to the total page length. This facility might be useful for 
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leaving part of the page clear, so that a diagram could be added later on. 


Examples. FjsP3—  (@jsezx+g 


ss Single Spacing 


This command is equivalent to LS1, and ensures that no extra blank lines are printed out 
after each line of text. 


Example. gjss 


Ti Temporary Indent. Range 0-line length less 10, default 0 


This command starts printing on a new line, and indents that line by the given amount from 
the left margin. This enables you to indent the start of a paragraph, although this could 

also be done with spaces. Using TI provides a way of producing a “hanging” indent, whereby 
the first line of a paragraph is up against the left margin, and the rest indented by a 

certain amount. You can do this by starting the paragraph with eg 


GINS 10m 
Examples. GTI3—9 (rin*® 


TS Top Space. Range 0-50, default 6 


In the interests of neatness, a few blank lines are printed out at the top and bottom of 
each page. The precise number of lines can be controlled with TS and BS respectively. 
These blank lines contribute to the total page length, so that the number of lines of 

actual text on each page is the page length (PL) less the top/bottom spaces. Remember that 
EP (enable paging) must be used before the page related commands have any effect. 


Examples. JjTSsf (jrsex®™ 


UE Underline End 


UE cacels the effect of US, or underline start. Thus it causes the printer to cease 
underlining text. It does this by sending out suitable numbers to the printer, but the 

default numbers (27,45 and 0) will only work with an EPSON compatible printer. If you are 
using a different type, then it may be necessary to alter the codes sent out as a result 

of UE. This is done by means of RPS1. If the printer needs ESC+Z to stop it from 
underlining, then you would need to use RPS2,27,"Z" before the UE command. 


Example. Q@JUcR 


US underline Start 
The opposite of UE, this makes EPSON compatibles start underlining. US sends the codes 


stored in printer sequence 0, so use RPSO to alter them from the defaults of 27,45 and 1. 
See RPS for more information. 


Example. fu si 
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introduction 


The idea of text and segments in WORDWISE PLUS (WW+) has been likened to a large hall with 
movable partitions. The overall size of the hall remains unchanged, and is analogous to 
the computer’s memory. The partitions can be used to split up the available area in any 


suitable way. If a very large section is used for something, then there is correspondingly 
less space available for other things. 


A similar idea holds true for the text and segments in WW+. There are ten segments 
numbered 0-9, and just one main text area. All of them may have characters typed in as 
normal, and edited in the usual manner. 


If you were to enter a great deal of information into the main text, then this would leave 
very little room in the ten segments. You might decide to leave all ten segments empty, 
and only use the main text. Remember that the sole restriction is the total memory 
available. That memory can be allocated as you see fit. 


WW+2 provides an easy way of moving from one segment to another, or to the main text. From 
edit mode, [esiW@iii} moves to the chosen segment, and [@{MWAg selects the text. 


An obvious way to use a segment is as a sort of note-pad. Imagine that you are entering 
information into the main text, and an important idea suddenly occurs to you. Simply press 
to select segment 0, and type in something as a reminder. Finally, 
selects the text again, with the cursor in the same place as before. We only used segment 
© as an example, and any of the other nine could have been used instead. 


The second way to use segments is to store programs in them. This is the most powerful 
application, but many users are discouraged by the thought of programming, and immediately 
dismiss it as being “too difficult”. A segment program could be just one line long, 

although admittedly it would not be able to do very much. It would be hard to provide a 
convincing argument that such a program was complicated however. 


What can a segment program do? 


In order to answer this question, think for a moment about the sort of operations which 
occur during normal editing of a document. The flashing cursor can be moved around at 
will. Once suitably positioned, characters may be erased or new ones entered. Markers can 
be imserted, and the resulting marked section moved elsewhere, copied or deleted. Text can 
be loaded and saved, and documents merged together by using the “load to cursor” facility 
from the menu. 


The power of a segment program stems from the fact that it could do all of these things, 
and 2 lot more besides. A segment program is a collection of instructions, each of which 
is relatively simple in its function. A segment program often contains commands to move 
the cursor in a particular direction, or to type new characters. 


The usual way to move the cursor one place to the right while editing is to press JMI@alg- 
We will now illustrate that there is another way of doing this which, although it doesn’t 
save any time, at least introduces one of the special WW+ commands. 


You meed to go into edit mode, and enter about a dozen characters. Then move the cursor to 
the left so that it is roughly in the middle of what you have just typed. Make a careful 
mote of the character immediately above the cursor, and then press to return to 

the menu. Now type 


CURSOR RIGHT 
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Nothing appears to happen, apart from a “Press any key” message. If you now return to edit 
mode (ie press a key and then again), you will see that the cursor has moved one 
place to the right. 


We have succeeded in demonstrating just one of the commands available, although the effect 
is not particularly striking. CURSOR is a special “keyword”, which WW+ recognises and can 
act upon. It will not come as a great surprise to learn that the cursor could similarly be 
moved up, down, or to the left. 


Why would you want to do this, when it is apparently so much easier just to press the 
relevant cursor key? Obviously, a document would not be edited like this in practice, but 
it is essential to realise that commands exist which simulate the ordinary editing 
functions. A segment program is a list of simple commands and statements. When that 
Program is run, each command is obeyed, one after the other. No further user intervention 
is required. 


This next example probably has little practical use, but it will hopefully show how a task 
which would be very tedious to do by hand is quite effortless when performed by a segment 
program. 


The objective is simply to count the number of full stops in the text. Let’s see how we 
would do this manually. 


1) Ensure that we are in the text area, and the cursor is at the top. 

2) Start counting from zero, since we have not yet found any full stops. 

3) Move the cursor to the next full stop in the text. We can do this by pressing 
(the “Move cursor to” option), and then pressing the "." key at the right hand end of 
the space bar. 

4) As a result of step 3, one of two things will happen. If a full stop could not be 
found, then the cursor will be right at the end of the text. Our task is then complete, 
and the total number of full stops should now be known. 

5) The second possible result of step 3 is that a full stop was indeed located. In this 
case, we must add 1 to our counter, and then go back to step 3 to find the next one. 


This would not be difficult to do, but apart from being slow, there is a certain amount of 
scope for error - we could easily lose count for example. 


Here now is a segment program to do all this for us. 


SELECT TEXT 
CURSOR TOP 

LET C%=0 

-step3 

se Ae 

IF EOT THEN END 
LET C¥=C%+1 
GOTO step3 


Although this program contains many special words which have not yet been defined, you 
should be able to relate each line back to the steps outlined above. EOT stands for End Of 
Text, 


In order to use this program, you must type it into one of the ten segments. That segment 
can then be run by pressing E¥[a@sgil, where is the appropriate function key. 


After the program has executed, the number of fui! stops in the text will be stored in C%. 
In order to see the answer, return to the menu and type 
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:PRINT C% 


Notice how much quicker the program approach is than doing it by hand. The effort required 
to write the program is a once-only overhead, and the same program could then be used to 
count the full stops in any other document that you care to load in. 


Observe also how a command can be used from the menu by typing a colon followed by the 
command itself. The colon must not be included in segment programs. 


When do you use a segment program? 


Generally, a segment program is useful when the job has a repetitive nature. Computers are 
very good at doing things many times over, as the example involving full stops showed. 
Printing addresses on sticky labels from a file is another instance where a segment 

program can assist. Programs can be just a few lines long, or perhaps several hundred. 


How do you run a segment program? 


To run the program in segment number n, press [E¥I@@au). It often happens that there will 
be no visible indication that a program has started executing or that it has ended, and 

this can be disconcerting at first. The exception to this is when commands have been 
deliberated included in the program to keep the user informed of its progress. You can run 
2 program from both edit and menu modes. In the latter case, the screen flickers briefly 
when 2 program ends. 


A common error encountered when users first start experimenting with programs is “Can’t 
execute”. A segment program cannot edit itself, so when attempting to use CURSOR commands 
(say) you must previously have selected the appropriate target area. ie the main text or 

ome of the other 9 segments. See the SELECT command. 


A segment program cannot be run from the main text area, only one of the segments. 


Variables 


As 2 program proceeds, it may need to keep track of various things. This might be the 
mumber of addresses which have been printed out, the size of a data file, the name of an 
important file, and so on. The WW+ programming language uses variables in a very similar 
way to BASIC, although there are much fewer available. Two sorts of variable are 
recognised by WW+, numeric and string. 

In WW-+, the only numeric variables are A% to Z% inclusive. These variables can store only 
whole, positive numbers. They are represented with two byte accuracy, which means that the 
largest number that each one can hold is 65535. This is more than adequate for many 
applications. 


It turns out that P% and W% are respectively used to hold the current page number and word 
count. This means that normally they should not be used in a program, and therefore only 
24 wariables are freely available. 


Strimg variables are A$ to Z$. Each one can hold any number of characters up to and 
imcluding 255. There is a further restriction in that the total number of characters 
stored in all the string variables cannot exceed a certain amount. This is currently 437, 
although earlier versions of WW+ had a slightly higher figure. If you try to assign 
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characters to a string when insufficient space remains, then an error message will be 
given. The function VARFREE will tell you how much free space still remains in the string 
variable storage area. 


The ASCII values of characters assigned to a string variable can only be in the range 
0-126 inclusive. This includes all the normal printable characters, so again it is 
unlikely to be a restriction. When WW+ is first entered, all 26 string variables are 
“null”, ie nothing is assigned to them. 


Two string variables are used by WW+2. F$ stores the last filename used to load and save 
the main text, and S$ serves a similar purpose for the segments. 


Operators 


As in BASIC, the WW+ language Supports certain operators. An operator is something which 
takes two (usually) quantities, and then performs some kind of action on them. This might 
be a comparison to see if they were the same or adding them together, although operators 
can do other things too. 


Some operators have a higher Priority (precedence) than others. For instance, 
multiplication is carried out before addition. Brackets may be used in WW+ to force part 
of an expression to be worked out first. You can find out more about operators and their 
Precedence on page 144 of the computer User Guide (page K.2-7 in the Master Reference 
Guide). Much of what follows assumes that you have done this, or have the necessary 
background knowledge. 


Rather than list all the operators which are provided in WW+, it is easier to compare it 

with BASIC and mention the ones which aren’t. In group 1, there is no unary minus, unary 
plus or NOT facility, and the only indirection operator is "?", In group 2, exponentiation 
(the only operator in this group) is not supported. 

A unary operator is one which only acts on a single quantity, such as the "-" in "-5", 

Since WW+ does not allow negative numbers, there is no need for the unary minus. A number 
is assumed to be positive anyway, so likewise the unary plus is not required. You can 
simulate the NOT function by reversing the sense of a test, eg 

IF NOT(J%>=7) THEN... becomes IF J%<7 THEN... 


If the test is more complicated, then simply equate it to 0. The first test below might be 
used in BASIC, and the second shows how to do the same thing in WW+. 


IF NOT(A%>B% OR (E%<(G%+2)) EOR H%< (K%¥+(R*®¥*4))) THEN... 
IF (A%>B% OR (E%<(G%+2)) EOR H%< (K%¥+(R¥%¥*4)))=O THEN... 


The "?" indirection operator can only be used to read from memory, and not to write to it. 
Thus 


X%=?7B% will work, but ?BR=X% will not. 
There is more information on page 409 of the model B User Guide. 


The group 3 and 4 operators are all Provided, but only use integer arithmetic. Both 
strings and numbers may be compared using the operators in group 5, eg 


IF X%>7 OR H$=B$ THEN GOTO nextbit 
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Groups 6 and 7 are the logical operators. You can use them to arrange complicated tests, 
or to manipulate individual bits in a number. Like BASIC, WW+ represents its numbers in 
binary. * 

IF A%=5 OR B%=6 AND R®=K% THEN... 


PRINT H% AND 2 
B%=T% OR 5 


When dealing with strings, the only operator is "+", and is used for joining them 
together. Eg 


A$="B"+"CD" gives A$="BCD" 


Number bases 


WW+ assumes that a number is in decimal (base 10) unless otherwise indicated. Other bases 
are allowed by adding a suitable prefix. 


% Binary, base 2 
@ Octal, base 8 
& Hexadecimal, base 16 


Thus; 


PRINT %111+&20+@10 gives 47 


Labels 


Each line of a BASIC program has a line number associated with it. This enables any 
particular line to be referenced with a GOTO statement for example. WW+ programs do not 
have line numbers as such, but it can likewise be useful to be able to branch to any 
chosen point in the program. This is achieved by using a label. 


A label is a period "." followed by a sequence of characters. These characters can be 
virtually anything, but no spaces must occur. Examples of valid labels are; 


Labels are ignored when they are encountered during the normal flow of execution. Both 
GOTO and PROC need labels after them. 


Commands and Functions 


We bave already encountered some of the things that are likely to occur in a segment 
geogram. These are the integer and string variables, and also the operators such as +, —, 
aad OR. 


The WW-+2 language recognises dozens of special “keywords”, and they usually fall into one 
of two categories. Either it is a command, or a function. A function returns some kind of 
vesalt, for example LEN counts the number of characters in a string. On the other hand a 
command is an instruction to the computer to do something. 


Page-83 


Segments & segment Programming 


A few keywords do not really come under either heading. An example is the word PARAMS, 
which never occurs on its own, but always after SAVE or LOAD. It isn’t usually essential 

to know whether a particular keyword is a command or a function, more important is knowing 
how to use it correctly. There is no substitute for trial and error, and it does no harm 


to experiment. You may find that the "Segment Programs” disc provides a useful source of 
examples. 


Case of letters and abbreviations 


When working in BASIC, all keywords must be in upper case letters only. This is not so in 


WW+, and you can use any combination of upper and lower case. Hence the following produce 
the same result; 


PRINT 3+4 PrInT 3+4 


The WW+ variables must be in upper case, so a% will not do. Remember also that keywords 
can be abbreviated by means of a period (eg. P. for PRINT), which can produce very 
worthwhile memory savings. Even better is to tokenise programs, which not only saves 
memory but also increases the execution speed. There is more information on tokenising in 
the "Utilities Disc” section. 


Chaining programs 


Since there are ten segments, it follows that you could have up to ten separate programs 

in memory simultaneously. Only one program can be running at any instant however. When a 
program ends, it can sometimes be useful if another one is made to run automatically 
("chained"). This can be done by putting a suitable number into the keyboard buffer before 

a program ends, effectively fooling the computer into thinking that has been 

pressed along with a function key. 


This is achieved with *FX138. To make a Program “chain” the program in segment number n, 
the rule is to place 144+n into the keyboard buffer. Use OSCLI for this purpose. Eg. 


N%=7 
OSCLI"FX138,0,"+STR$N% 


It may be wise to use *FX15 to flush the buffer first. This will ensure that the computer 
does not become confused by data that is surplus to requirements. 


Errors 


There will be times when WW+ cannot recognise a command, or is unable to evaluate an 
expression for some reason. When a program is running and an error occurs, the program 

Stops, the appropriate error message flashes at the top of the screen, and the cursor is 
positioned under the line at fault. Almost invariably the error message is 

self-explanatory. Careful scrutiny of the line in question should reveal the problem. 

Spelling mistakes are common (PIRNT), but you may also be using a keyword illegally. Check 
the syntax with the descriptions that follow. 
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Bm 
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a a 


Standard commands and functions 


NOTE some functions or commands relate only to single bytes, BPUT# for example. At 
the same time, WW+ evaluates expressions to two-byte accuracy. When a single byte is 
required, only the least significant byte of the result is used. Hence the effect of 
BPUT#J% , &2375 


is to write &75 to the file, and the &23 is ignored. In general, when a single byte is 
needed from a two byte result, it is obtained from; 


result AND. &FF 


* 


Any line in a segment program can be an operating system command. See also OSCLI. 


*HELP *CAT *ACCESS FILE 


ASC 


This function returns the ASCII value of the first character of its string argument. See 
also page 207 of the model B User Guide. 


A%=ASC"R" PRINT ASC(T$) B%=4+ASC(J$) 


BGET# 


SGET* will obtain a single byte from an open file. It must be followed by a numeric 
variable A% to Z%, which contains the “handle” for the file. The handle is often obtained 
by using OPENIN or OPENUP. See also page 212 of the model B User Guide. 


HR=OPENIN"datal” L¥=OPENIN(A$) 
BR=BGETS#HS PRINT BGET#L%+32 


BPUT# 


This is the opposite to BGET#. You use this command to write a single byte to an open 
file. As with BGET#, BPUT# must be followed by a numeric variable, and then the 
mumber to be written. See also model B User Guide page 213. 


%=OPENOUT “data” EX=OPENUP(D$) 
PUT#J%,65 BPUT#E%,LEN(A$) 


CALL 


CALL executes a machine code routine at the given address, so use with care. Before the 
rowtime is called, A, X and Y are primed from the least significant bytes (LSB) of Ah, X% 
and Y%. Bit O of C% is copied into the carry flag. Make sure that zero page memory in the 
range &00-&8F is not corrupted by the code. See also USR. 


==65 A%=126 CALL K% 
= &FFE3 CALL &FFF4 
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CHRS 


This function returns the character with the given ASCII value. It therefore produces a 
String rather than a numeric result. 


B$=CHR$(72) A$=CHR$N%+" ABC" 
PRINT CHR$100 L$=CHR$(M%+2)+"P" 


CLOSE# 


This command is used when you have finished with a data file. If the number after it is 
zero, then all open files will be closed. Otherwise, just the one file is affected. 


A%=OPENOUT "WwW" CLOSE#0 
CLOSE#A% CLOSE#K% 


CLS 


This command clears the entire screen by issuing VDU 12, leaving the cursor (NB not the 
text editing cursor) at the top left hand corner. 


CLS 


CURSOR 


This command enables a program to move the text cursor around a document. Be sure to use 


SELECT to choose the target area first. CURSOR must always be followed by one of these 
keywords; 


UP, DOWN, LEFT, RIGHT, AT, TOP, BOTTOM 


The first four move the cursor in the given direction, and furthermore may do so by a 
specified amount. AT allows the cursor to be positioned at any point on the line in 
the range 0-39, although not beyond the end of the last word. TOP and BOTTOM 
Tespectively move the cursor to the very start and end of the document. 


CURSOR LEFT CURSOR AT 34 CURSOR DOWN 9 
CURSOR RIGHT 3 CURSOR TOP CURSOR AT J% 
CURSOR UP T% CURSOR BOTTOM CURSOR AT O 


DEFAULTS 


This resets all the document layout parameters back to their default values (eg Line 
Length 70). 


IF G%=5 THEN DEFAULTS 


DELETE 


This command enables characters to be deleted from the currently selected target area. It 
must be followed by one of the following keywords; 
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LEFT, AT, WORD, MARKERS, MARKED, TEXT 


LEFT works like the key in normal edit mode, and AT is like Heeja@. Use of 

the keyword WORD causes the word above the cursor to be deleted. LEFT, AT and WORD may 
all be followed by a number indicating how many characters or words are to be deleted. 

If any markers are set, then they can be deleted using DELETE MARKERS. Marked text 

can be deleted with DELETED MARKED. DELETE TEXT deletes the currently selected 
target. Use any kind of DELETE command with care. 


CDELeTe LEFT DELETE MARKED DELETE WORD 5 
DELETE AT Y% DELETE MARKERS DELETE LEFT 4+J% 


DISPLAY 


When commands are used to edit the text (eg. DELETE), the display is not updated as it is 
in normal edit mode. Use the command DISPLAY to do this. It is sometimes possible to 
reduce screen flicker by including a number after DISPLAY, although to update the screen 
properly it will sometimes have to be left out. 


TYPE "A letter" DISPLAY 1 
DISPLAY 


DOLINE 


DOLINE may be used to print a line of text on the screen, allowance being made for the 
current document layout settings. Embedded commands may also be included and will be acted 
upon. 


DOLINE "|GCE;WCentralised" 


DOTHIS...TIMES 


This is one of two loop structures available, similar to FOR-NEXT in BASIC. The number of 
times through the loop is controlled by the expression after TIMES, and must not be zero. 


DOTHIS DOTHIS 
PRINT "*"; A%=A%+BGET#F% 
TIMES 50 TIMES 3*(K%¥+L%) 


This command unconditionally causes the program to cease running. 


mm 
z 


D IF S%>M% THEN END 


ENDPROC 


This is used to terminate procedures, called with the PROC command. Control returns to the 
Statement immediately after the calling PROC. 


ENDPROC 
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EOF# 


This function is used to see whether the end of an open file has been reached, and returns 
the result TRUE (65535) if so. Otherwise EOF # produces zero. EOF # must be followed by a 
numeric variable, which contains the handle of the file in question. 


IF EOF#B% THEN CLOSE#B% 
IF EOF#J% OR K%=3 THEN GOTO endfile 


EOT 


The editing cursor can be moved around the document under the control of a program. This 
function enables you to tell whether the cursor is right at the very end of the text. If 
so, EOT returns the result TRUE (65535), and FALSE (0) otherwise. 


FIND "x" 
IF EOT THEN GOTO notfound 


EXT# 


This function returns the number of bytes in a file, the actual file being defined by the 
value of the numeric variable. 


J%=OPENIN"data7" ABZ=EXT#RE+4 
PRINT EXT#J% FR=Z2*EXTHQK 


FALSE 


FALSE is a function which always returns zero. 


PRINT FALSE+3 K#=FALSE+Y% 
UNTIL FALSE D%=FALSE 


FIND 


The FIND command is a way of moving the cursor to any given string. If the string is not 
found, the cursor will be left at the end of the text, and you can test for this using 

EOT. The cursor doesn’t move if it is already under the String, so sometimes it is 

necessary to move the cursor to the right. The search string may contain wildcards, as 

well as special sequences representing eg | TAB R For example, |W means “white”, ie 
embedded command end. The FIND command is the only way to search for a marker. The 
search can be made case (in)sensitive using *NOCASE and *CASE. 


FIND "|GLM##;W" FIND B$+"{R" 
Fa NOn i Ee FIND MARKERS 


FKEY 


Using FKEY, a program can simulate the pressing of one of the red function keys. Hence 
FKEY3 will insert a marker. Some function keys require another key press after them (eg 
i. and it is possible to specify the key by putting a character after the FKEY. 
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FKEY 3 FKEYS6R' ER" 
Prey “45° E" FKEY K% 


FREE 


This function returns the number of characters free, as shown at the top right of the edit 
screen. 


A%=FREE+C% 
IF FREE<100 THEN GOTO not_much_room 


GCFS# 


GCF$# is used for getting a character from a file, the file having been previously opened. 
A numeric variable must follow GCF $#. The file “pointer” advances by one each time GCF $# 
is used. 


J%=OPENUP"data” L$=GCF$#M%+CHRS$ (EX) 
A$=GCF$SH#IU% P$=GCF$#M%¥+GCFSH#HUS 


GCKS$ 


Get Character from Keyboard is rather like GET$ in BASIC. The function causes the machine 
to wait until a key is pressed, and it returns with the appropriate character. 


A$=GCK$ L%®=ASC(GCK$)+4 
PRINT GCK$ J$="E"+GCK$ 


GCTS$ 


This function (Get Character from Text) obtains the character immediately above the cursor 
from the currently selected target. It then moves the cursor one place to the right. Use 
CAC$ if you don’t want the cursor to move. 


PRINT GCT$ A%=ASC(GCT$) 
BS$=GCT$ IF GCT$="W" THEN. GOTO done 


GET 


This function waits for a key to be pressed, and then returns the ASCII value of the 
character generated. 


ivGET IF GET=32 THEN GOTO space 
ET UNTIL GET=65 


GLFS$# 


This function gets a line from a file. The file handle is specified by the numeric 
wartable after it. Characters are read out until a carriage return is found, or 255 
characters have been obtained, or the end of the file is reached. In the first case, the 
carriage return itself is not included in the string. 


N 
G 
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A%=OPENIN"data" GR=LEN(GLF$#Y% ) 
H$=GLFSH#AK K$=GCT$+GLFS#T% 


GLKS 


GLK$ gets a line of text from the keyboard. Termination of the input line occurs when 


atten) is pressed. 


PRINT “Enter file" J%=LEN(GLK$ ) 
A$=GLK$ IF GLK$="ABC" THEN GOTO edit 


GLTS$ 


This function (Get Line of Text) is similar to GLF$#, but reads characters from the 
currently selected target area. The first character read is the one above the cursor. 
Characters are read until a carriage return is found, or 255 characters have been 

obtained, or the end of the text is reached (indicated by a beep). The cursor moves to the 
right as characters are read. 


A$=GLT$ IF GLT$=G$ THEN GOTO found 
J%=LEN(GLT$) Q$=GLT$+"Q" 


GOTO 


This command is used to branch to another part of the program. You indicate the precise 
point by means of a label. A label is a period followed by one or more characters, but no 
spaces are permitted. 


GOTO hop IF EOT THEN GOTO finished 
LS eae GOTO save 
.hop 


IF... THEN 


IF enables the machine to do something only if some particular condition prevails. The 
Statement after the keyword THEN is executed if the expression after the IF is TRUE, and 
ignored otherwise. 


IF H¥=7 THEN K%=9 
IF G%¥>22 THEN PROCedit 


There is a variation on this format, which allows several statements to be executed as a 
result of one IF. This is obtained by ensuring that nothing (apart from spaces) occurs 
after the word THEN, eg; 


IF J®=22 THEN 
L%=7 
PROCedit 
PROClist 


The statements up to the semicolon are executed only if the condition is TRUE, and ignored 
otherwise. This construct cannot be nested, ie it must not occur inside another such loop. 
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LEN 


This function returns the number of characters in a string. Remember that spaces and 
carriage returns are characters in their own right. 


A%=LEN"a bec" K%¥=LEN(C$+H$ ) 
H%=LENB$ L¥=4+LEN(K$) 


LET 


The keyword LET may optionally be placed before an assignment. These two statements are 
equivalent. 


H$="ABC" LET H$="ABC" 


LOAD 


LOAD is always followed by one of these keywords; 
TEXT, TTC, PARAMS 


These in turn are followed by a string expression representing a filename. 

LOAD TEXT loads a file into the currently selected target, with no warning about 
text being overwritten in the process. TTC stands for Text To Cursor, and is 
equivalent to menu option 4. LOAD PARAMS primes the document layout parameters 
(embedded command values), including the RPS sequences. 


LOAD TEXT "FILE" LOAD PARAMS B$ 
LOAD TTC "PART2" 


OPENIN /OPENOUT 


Before a data file can be written to or read from it must first be opened. In doing 

so, 2 “handle” is returned, so that certain commands which deal with files will know 
exactly which file is involved. OPENIN implies that a file will only be read from 
only input"), and OPENOUT is used when the file will be written to only (“output”). 
OPENUP is needed if you wish to do both. 


AZ=OPENIN"data" H*¥=OPENOUT (L$) 
BE=BGET#AR BPUT#H% , K% 


OSCLI 


This command passes a line over to the operating system rather like a star command. The 
difference is that OSCLI allows a string expression to be used, and can therefore contain 
variables. 


OSCLI("DELETE "+A$) OSCLI"ACCESS “+F$ 
OSCLI“FX138,0,"+STR$M% OSCLI“ HELP“ 
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PREVIEW 


This command may be used to preview a document (either in memory or on file), and must be 
followed by one of these keywords. 


FILE, MARKED, PAGE, TEXT 


PREVIEW FILE takes the named file, and displays it on the screen. Any embedded 
commands are acted upon. PREVIEW MARKED shows the text between two markers. 
PREVIEW PAGE shows just a single page, the actual page number being specified. 
PREVIEW TEXT previews the entire text in memory. 


An important feature of PREVIEW is that it does not reset the embedded command settings to 
their default values. The DEFAULTS command is available if needed. 


PREVIEW FILE B$ PREVIEW PAGE 7 
PREVIEW MARKED PREVIEW TEXT 


PRINT 


This command can be used to print messages on the screen, or the results of calculations. 
Numbers may be printed in hex by using the tilde, "~". If the last character is a 
semicolon, a new line is not generated. 


PRINT ~A%*B%; PRINT "Hello" 


PRINT may also be followed by one of the four keywords listed under PREVIEW. The effect is 
very similar, the obvious addition being that the printer is activated. Like PREVIEW, 


PRINT does not reset the document layout parameters, so you may need to issue a DEFAULTS 
command first. 


PRINT FILE J$ PRINT PAGE K% 
PRINT MARKED PRINT TEXT 


PROC 


This command calls a procedure, a procedure being one or more statements terminated by 
ENDPROC. After ENDPROC, the next statement executed is the one after the calling PROC. It 
is possible for a procedure to call another one. All variables in WW+2 are global. 


The start of the procedure is marked by a label. You specify which procedure is required 
as part of the PROC command. 


PROCadd PROCfind 
PRINT C% PROCfile3 
END PROCabc 
.add 

C®¥=A%+B% 

ENDPROC 


Page-92 


Standard commands and functions 


PTR# 


As Gem files are read from and written to, a “pointer” keeps track of the current 
pesttien. It is possible to set this pointer to a desired value, or to read it so as to 
@scertein the present position in the file. When a file is first opened the pointer is at 
pesities ©. The file in question is indicated by the numeric variable after PTR#. 


IF PTR#R%>500 THEN H%=4 
PTR#K¥=JS% 


RECOUNT 


When text is edited using programming commands, the word count is not updated. To do this, 
ase the RECOUNT command. The word count will be copied into the variable W%. 


THEN RECOUNT 


Any line starting with REM ("REMark”) will be ignored. This is useful for documenting 
programs. 


REM This does nothing 


REPEAT...UNTIL 


This is the second type of loop structure available. The loop repeats until the expression 
after the UNTIL is TRUE (65535). Like DOTHIS, REPEAT loops can be nested. 


REPEAT REPEAT 
A$=GCT$ PROCsomething 
UNTIL A$="*" UNTIL EOT 


REPLACE 


REPLACE must always be followed by two string expressions. The first is the search string, 
and the second is the replace string. Only one replacement takes place, so a loop will be 
meeded to replace all occurrences of something. The search starts from the current cursor 
pesition, and the cursor is left at the end of the text if the search string could not be 
fownd. As with FIND, characters such as need a special character sequence, | 7 in 
this case. See also the FIND command. 


REPLACE A$,H$ 


“ "ww" REPLACE "%%%",L$ 
REPLACE R$, K$+"QQ" 


SAVE 


SAVE must be followed by one of three keywords; 


TEXT, MARKED, PARAMS 
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These must then be followed by a string expression representing a filename. 

SAVE TEXT saves the entire currently selected target area, and SAVE MARKED saves only 
the marked section. SAVE PARAMS saves the region of memory used to store the embedded 
command settings, and also the RPS values. See also LOAD. 


SAVE TEXT A$ SAVE PARAMS B$+"2" 
SAVE MARKED "“part2" 


SELECT 


Before you try any sort of cursor movements using a program, you must indicate the area 
that is to be edited. This can either be the text area, or one of the other nine segments. 


SELECT. TEXT SELECT SEGMENT 4 
SELECT SEGMENT K% SELECT SEGMENT W%+H% 


SOT 


This stands for Start Of Text. It is a function that returns TRUE (65535) if the cursor is 
at the very start of the first line of the text, and FALSE (0) otherwise. 


CURSOR LEFT 3 
IF SOT THEN PRINT "Done" 


SPOOL 


SPOOL is a command which sends a document to a file in its formatted state. It is 
rather like previewing the text, but everything shown on the screen also goes to a 

file. Hence there will usually be a lot of extra spaces in the spooled version. 

Before issuing SPOOL, it may be necessary to use the DEFAULTS command to reset the 
layout parameters. SPOOL must be followed by one of the following keywords; 


TEXT, MARKED, PAGE, FILE 


SPOOL TEXT must have a filename after it, and the complete document in memory is spooled. 


SPOOL MARKED also needs a filename, but only the marked section of text is used. 
SPOOL PAGE must have a file specified, and the page number too. 


SPOOL TEXT J$ SPOOL PAGE B$ , 6 
SPOOL MARKED “part7” 


SPOOL FILE requires two filenames after it. The first is the “source” file, and the second 
is the destination file. In other words the first file is spooled, and the output goes to 
the second. 


SPOOL FILE "Source" , “dest" 
SPOOL FILE B$ , “doc” 
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STRS 


Thas function converts a number into a string. It is not possible to use the tilde to 
produce 2 hex number, but HEX$ is available for this purpose. 


RSBX J%=LEN(STR$(M%) ) 
STRS$(K%) A$=B$+STR$(F%) 


SWAP 


The SWAP command does the equivalent of in edit mode. It “toggles” the case of 
letters, and does not affect other characters. It is possible to specify the number of 
characters to be swapped. The first character to be swapped is the one above the cursor, 
amd the cursor moves to the right by the appropriate number of places. Commands in a 
similar category are UPPER and LOWER. 


Swae SWAP K% 
SwaPe 5 SWAP M%+44*T% 


TIME 


This pseudo variable refers to the internal timer, rather than a real time clock such as 


ME T%=TIME-T% 


TRUE 


This femction always returns the value 65535. 


IF H%¥=TRUE THEN K%=FALSE 
F%=(D%=TRUE) 


TYPE 


Use tis command to enter new characters at the cursor position into the currently 


selected target area, chosen by using SELECT. It must be followed by a string expression. 
The word count is not updated. 


Hello’ TYPE B$+STR$(M%) 
AS TYPE GLK$ 


t ts also possible to place the keyword SEGMENT and a segment number after TYPE. The 
Tect is to copy the entire specified segment into the target area. 


¥PE SEGMENT 7 TYPE SEGMENT K% 
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VAL 


This function converts a string back into a number. The string must not contain any 
leading spaces, nor be preceded by a unary plus/minus sign. The function will return zero 
if this is the case. The number may start with a valid “base” prefix however. 


A%=VAL("&FF") PRINT VAL(M$) 
J%=VAL"%1101" K¥=6*VAL (M$+N$ ) 


VARFREE 


The string variables in WW+2 are restricted in terms of the total amount of memory 
available to store characters. The total length of all 26 variables cannot exceed 437. 
VARFREE can be used to indicate how much memory still remains in the string variable 
storage area. Use CLEAR to increase this amount. An assignment to a String variable when 
insufficient space remains in the buffer produces a "$ room" error. 


PRINT VARFREE IF VARFREE<50 THEN CLEAR 
A%=VARFREE+2 K%=VARFREE+M% 


VDU 


VDU sends characters to the VDU drivers. Generally, 
VDU N%& is equivalent to PRINT CHR$(N%); 


You can use VDU to perform special functions, such as moving the cursor (not the editing 
cursor) to a particular point on the screen, or turning the printer on. Several numbers 

can follow VDU by separating them with commas. In this case only the low byte of the 
number is sent. Optionally, a semicolon may be used after a number, and this causes the 
number to be sent as a two-byte pair, low byte first. Use VDU with care, since a mode 
change could delete the text and all segments. 


VDU 31,X%,Y% VDU 7 
VDU 2 VDU 136,65,66 


WORDS 


The WORDS function will produce exactly the same numeric result as W%. Both indicate the 


current word count. If W% has been used for something else however, then WORDS will no 


longer provide the correct word count. Use the RECOUNT command to update the word count. 


W%=WORDS K%=WORDS*6 
PRINT WORDS M$=STR$ (WORDS) 
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INTRODUCTION 


WORDWISE PLUS II comes complete with a set of utilities on disc. This offers a fairly 
diverse range of facilities. 


The main problem in supplying programs for use by WORDWISE PLUS II is trying to cater for 
widely waryinmg needs. One user may never want to use a mail-merge program, another may 
well fied it invaluable. We have therefore not adopted the “menu” approach which offers a 
lange number of options, some of which may never be used. Instead, each routine is clearly 
mamed, and the user can then load and try out that file if it seems to provide something 

ef value. 


IMPORTANT 


Desc Sased files are very easy to modify, and this enables us to update the existing 
peograms, and even provide new ones. However, changes like these unfortunately cause parts 
of tis section of the manual to become outdated. 


We beve therefore provided a file on the "Segment programs” disc called "README". This is 
= WW-2 text file, which can be loaded into memory in the usual way with menu option 2. It 
my them be read either by entering edit mode and scrolling through it, or by printing out 

= beré copy om your printer. In this way we can draw your attention to any additions or 
aiuerations to the package. 


General 


Poogremming in the WORDWISE PLUS Programming Language (WPPL) is not difficult. It is 
Sarprissme jest how much typing a short program such as 


cowlé sewe im the appropriate situation. Programs only start to grow in apparent 

complenity omce they are designed to be more “user friendly”. In the example above, we 
might wish to add windows and CLS (CLear Screen) commands, present a choice of several 
G@icrest options, put in colours and beeps with VDU and so on. The main effect is the 
mame 4bowever. 

1 methime else, these utilities should provide a useful source of ideas. You can see in 
ucem some of the commands and functions provided by WORDWISE PLUS II, and the 
appertanity is there to see how particular results have been achieved. 


Most of the more lengthy routines have been compacted to save memory. For example, 
“PRINT” bas been replaced by "P."”. This makes programs rather hard to follow, 
aitbeowsh 2 utility is provided for decompacting programs. 


We cam supply the original programs (including REM statements) on disc for just £3.75. 
Picase state 40 or 80 track. 


Seme utilities are quite short. In these cases, each program has been liberally sprinkled 
with REM statements to explain what is going on, and little more is said in this manual. 


Page-97 


Utility disc 


BACKING UP 


The disc supplied may be copied by the use of the *BACKUP command. Although the user is 
free to make as many copies as required in this manner, please note that the routines are 
nevertheless subject to copyright. 


RUNNING THE PROGRAMS 


The general procedure for running any of these programs is to load the named file into any 
segment, and then run it by pressing together with the appropriate function key. A 
segment program may be run from either the menu or edit modes. 


It would be possible to write a “menu” type of program which asked the user to type in the 
particular file which was to be loaded and run. As previously mentioned, a possible 
disadvantage with this approach is that the ideal set of programs is very much a personal 
choice. There is however an example program called MENU on the disc which illustrates the 
technique. 


ADDING PRINTER CODES 
File: PCODES 


Certain forms of word-processing tasks can involve a lot of repetitive typing. This is 
tedious at the very least, and often rather awkward when the character sequences in 
question are obscure printer commands. In this section we will outline some ways in which 
WORDWISE PLUS II can assist. 


For straightforward text the function keys are a useful asset. You define these from the 

main menu using the *KEY command, and the actual character sequence is then entered into 
your text by pressing and the function key itself. Special characters must be 
used if you wish to include control codes in the key definitions, and this was explained 

in more detail under *FKEY. 


The other way of entering strings of characters into your text is by means of a segment 
program. Suppose that the document in question is part of a technical manual, and that it 
is necessary to make frequent use of a particular feature of the printer. Suppose further 
that this feature is activated by the use of 


MeEss2,0,3, 6 


We wish to find a technique which enters this entire sequence for us with only one or two 
keys having to be pressed. This can be achieved by moving into one of the segments and 
typing in this short program. 


SELECT TEXT 
TYPE "|GES82,0,3,6!w" 
DISPLAY 


The sequence |G and |W are used to produce the equivalent of | £41] and . (G stands for 
Green, W for White). 


From the text area, it is now only necessary to run the segment program by pressing 
Euiias and the appropriate function key, and the required characters are automatically 
typed in. 
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What if we had several different sequences which we wanted to have readily available in 
this way? One obvious answer would be to put a similar program in another segment, the 
TYPE statement being the only one which would have to be altered. We would clearly be 
limited to 10 sequences using this method, although it must be said that this is more than 
adequate for most purposes. 


Perhaps 2 disadvantage with this approach is that we have to write down or remember what 
each segment does. It is possible to produce a single program to do the lot, but of course 
the program becomes longer. This does not necessarily make it complicated. 


A Segment program is provided on the disc called PCODES. It shows how to offer the user a 
Seice of wariows options, and then TYPE the selected one into the text. Plenty of REMs 
are imcleded. so it should be clear how it may be modified to suit the users needs. 


SEGMENT PROGRAM UTILITIES 


File: SEGUTII 


Associated file: KEYWORD 


Tiss program provides a number of handy routines for use on segment programs. The main 
purpese is to compact them to save memory, but another advantage is that compacted 
programs rum a bit faster. This process involves a number of separate stages, such as 
tekime owt spaces, REMs, changing keywords into abbreviated forms and so on. It is 
imppertant to rum the various options in the order presented in the menu, and it is wise to 
Seve = copy of the program before compacting it. A special option, ’Z’, allows a complete 
biitt om @ program by running the first four choices one after the other without further 
imtervention. 


When tkimg out spaces REM statements are not affected, neither are star commands. 
Complicating factors are the need to avoid deleting spaces between quotation marks, and 
the space in 


AZ=E54 ANDBS 
& important, otherwise the hexadecimal number merges into the AND operator. 
im te case of removing REMs, any REM statement which has an asterisk as the first 


mem-spece after the REM will not be affected. Hence a method is provided for ensuring that 
certsim important REMs will remain. 


The process of compacting keywords will only work properly if the keywords are written 
emlirely im upper case letters. It works by reading a table of conversions out of the file 
EEYWORD. 

Tie lsbel compactor converts labels into eg. “.a", “.b" etc, again to save space. Once 
“2” ts reached, the next labels are ".aa", ".ab” etc. References to those labels are 
cSangeé accordingly. 

DISASSEMBLY LABELLER 


Pie DLAB 
Associated file: DTEST 


Tis atility will take the spooled output from a disassembler and substitute labels for 
sbselute addresses. As an example, 
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6000 LDX #&09 A2 09 
6002 LDA &6000,x BD 56 34 
6005 JSR &FFE3 7A 8 =i Ol 2S 
6008 DEX CA 

6009 BNE &6002 DO 07 
6O0s -—— RE 


is converted to 


-labOOO:LDX #&09 
-lab001:LDA 1ab000,x 
JSR &FFE3 

DEX 

BNE lab001 

EQUB &FF 


The labels could then be changed to something more meaningful by the use of a search and 
replace operation. 


Not all disassemblers produce their output in exactly the same way. The utility relies on 
knowing the precise number of spaces between the various parts (e.g. between mnemonic and 
operand). The program is not compacted and is thoroughly REMmed, so customising it to suit 
should not be difficult. 


You can try out this program on the file called “DTEST” which is present on the disc. (It 
is part of the BASIC ROM disassembled with our B-UTILITY toolkit). Load DTEST into the 
text area and DLAB into a segment. Finally, run that same segment. 


STRIP EMBEDDED COMMANDS 


File: EMCOM 


This utility will remove embedded commands from a document. The entire text can be 
affected, or just the marked section only. Embedded codes can also be removed by spooling, 
but this approach can lead to a file which possibly has a lot of unwanted spaces in it. 


DISC UTILITY 


File: DSORT 
Associated file: MCODE1 


WORDWISE PLUS II provides a convenient file loading/saving facility from the main menu by 
means of the key. It does not tell you what each file actually contains however, 

and you are therefore forced to rely on the filename itself to provide the necessary 

clues. 


This program will enable you to examine each file on the disc, with additional 
opportunities to load a particular file or delete it. It may well prove invaluable for 


sorting out important and redundant files. 


This utility makes use of a machine code program called MCODE1, so it can be convenient to 
copy MCODE1 onto every disc that you wish to examine. To do this proceed as follows. 


1) Insert the supplied disc in the drive 
2) Enter LOAD MCODE1 
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Imsert the new disc into the drive 
Emer *SAVE MCODE1 900+FF 


Tis effectively copies the MCODE! file, but will not corrupt your text. 


Tiss program enables the user to print out multiple copies of his or her document. It is a 
Smightiorward program, also very useful at times. 


Sieweme sewed 2 file to disc, it can be useful to have a way of making sure that it can be 
lemded Geck successfully. One method of doing this is just to use the menu option to load 
= eget. If there is any kind of disc fault however, the chances are that you will lose 
year Set i memory. You are then left with the problem of trying to salvage something 
teem = Wowblesome disc. This utility will help to prevent this type of situation from 
aesemg it works by comparing the file on disc with the text in memory a byte at a time, 
ent so i will pick up the slightest discrepancy. 


& mwammber of programs have been provided which make use of a file of names and addresses. 
Yee cemmet realistically expect any word-processor to be as powerful as a true database 
Qeegrem. Set it is surprising what can be achieved with the WPPL. 


Tis atilty will be useful if you ever need to produce a list of names and addresses, 
perhaps = preparation for a mailing list. The names can be sorted (by surname), or 
mwiieemes with certain strings of characters extracted and made into a separate list. 


Witem She routine is run the screen offers the following options. 


=) Select filename (ADDR) 

tL) teac addresses to Text/File 
S) Sort addresses 

7) Exit to text 

* ©o.S. call 


The Qefeslt filemame is "ADDR’, and there is a demonstration file under this name on the 
Sec 1) comteins 2 list of about 20 names and addresses. To process another file, just 
gees FF. and then type in the new filename. 
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ADDRESS LOADING 


*L’ enables you to load the addresses either into the main text area at the current cursor 
position, or to send them to a separate file. The general idea is that you may type in a 
*search’ string, and the program will then proceed to read the addresses out of the 

relevant file, and TYPE into the text (or write to file) all those addresses which contain 


the specified string. This process may be performed on either a global or a selective 
basis. 


The first decision to make is whether the addresses are to be typed into the text, or 


written to a data file. In the latter case, it will also be necessary to supply the name 
of the file itself. 


The next prompt is for the user to insert the disc with the chosen file on it (i.e. the 
file containing the names and addresses). If the file cannot be found, then an error 
message will be given to this effect. Assuming that all is well, you are then asked 
whether the transfer of addresses from the file is to be global or selective. 


If you choose the selective option, then the address will be displayed on the screen, and 
the user asked whether or not it is to be included in the collection. A global choice will 
result in every address containing the search string (see below) being typed into the 
text/file. 


The search string itself is then requested. Each address is read from the file in turn, 

and checked to see whether this string is present in it. If so, then it will be TYPEd into 
the text or sent to the output file. Of course, confirmation of this is required first 

when a selective operation has been chosen. 


The case of the search string and the case of the letters in the addresses on file are 
irrelevant. Thus it is permissible to enter ’London’ as the search String, and still 
locate addresses which contain "LONDON" or “London”. 


Spaces are disregarded completely when performing the search. This has been done so that 
you may enter 


A.Jones 


as the search string, and not worry if there was a space (or two) between the initial and 
surname in the file. 


The program ascertains whether the search string is present in the address by using the 
POS function. Remember that this is one of several functions which take account of a 
*wildcard’ via W$. The program sets W$ to “#", which means that using 


sm#t 


as the search string would locate names such as “Smith”, “Smythe” and so on. By using a 
single ’#’ on its own, and opting for the ’selective’ loading, you will then be able to 
view each and every address before deciding whether or not to use it. This enables you to 
sort out the address file purely on a “see it, then decide” basis. 


SORTING 


You may want to sort the list of names and addresses into alphabetical order. Entering ’S’ 
will allow the user to do this. As before, insert the correct disc so that the computer 
can make sure that the file is present. 
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Tie ailiiresses to be sorted may either be in the text area already, or in the file as shown 
e@er opties “F. By default, this file is "ADDR’. See above for details on changing this. 


W te addresses are on file, then they will be loaded into the text area first before 
sertime Therefore any material in this area will be destroyed. Save anything valuable 


== 

Lastly. emter "Y" or "N’ when asked if the address file is to be loaded or not. ’Y’ means 
“eee che memed file will be loaded into the text and then sorted. "N’ means that the 
wiivesses cam already be found in the text area. transfers control back to the 


Sertime will mow commence. Each name is printed as it is sorted. Note that it is not 
seallly feasible to interrupt this process without leaving the addresses jumbled up, so try 
w vesest pressing [55 Slag- 


t 


The fimished list is not automatically saved. This must be done manually, preferably under 
a @effereat name. 

"T Gree the sub-menu just exits to the text area. You can also access any ’star’ 

@perstine system) command so that, for example, it is easy to catalogue the disc, change 


le would be possible to extend this program by including a wider range of data files for 
the adresses. This could speed up certain kinds of search, since the routine could 

geedict the exact file in which a given (surname) could be found. This is another program 
which bes been supplied in non-compacted form to aid users in modifying it for their own 
purpose. 


NOTE 


The sertime rowtine is rather inflexible, in that it only allows you to sort by surname 
amd i= sscending order (ie “Aardvark” at the top). It is also relatively slow, mainly 
beceuse it is written as a segment program, but partly because it uses a “bubble sort”. 
This oype of sort is notoriously inefficient when large numbers are involved. Typically, 
OO addresses can take about 8 minutes to sort. 


We eve = routine available for sorting purposes which operates from sideways RAM. Since 
@ & written im machine code it is very fast, 100 addresses usually being sorted in about 
ome second. Many different options are provided, such as sorting single lines rather than 
perssrephs. or numerically instead of by letter. A *SORT command followed by optional 
pucumeters is used to access the facilities offered. 


The same utility also provides an automatic letter case checking routine, and also a 
“uick seve” option. The latter enables you to save your text from within edit mode, just 


zy pressing | SHIFT /CTRL/QF This is invaluable for saving the text at regular intervals. 


Pease ask for further details. 
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LABEL PRINTING 


File: LABELS1 & LABELS2 
Associated file: ADDR 


This utility will enable you to print out a list of names and addresses stored in a data 
file. The obvious application is to produce them on self-adhesive labels which are 
available on tractor-feed paper. Two programs have been provided for label printing. 
LABELS! will only print a single column, but has an advantage in that it will justify the 


address centrally on the label giving a much neater appearance. LABELS2 will print in 
either 1 or 2 columns. 


A sample file containing suitable names and addresses is available called ADDR. 


Dual Column (LABELS2) 


When run, this program sets up a display indicating the current label parameters, and the 
various options open to you. The top six lines show the parameters controlling the label 

format. These parameters are necessary in order to cater for the wide variety of different 
label sizes. 


1) Indent. This determines how many blank spaces are printed in front of the label. i.e. 
the indent from the left hand side. 

2) Lines in the label. How many lines can the label have printed on it? 

3) Quantity. Self-explanatory. 

4) Blank lines between labels. Vary this Parameter depending upon how far apart the 
labels are in a vertical sense. 

5) Number of columns of labels. This must be either 1 or 2. 

6) Label to Label width. Only relevant if you have specified two columns of labels. This 
parameter controls the positioning of the second column. 


To alter any of the above, press a key 1-6, and enter the replacement value. The machine 
tells you the permitted range for the parameter in question. Some experimentation will be 
called for in order to get the required settings. There is no point in wasting labels, so 

do your setting up on plain fanfold paper. 


The chances are that the default settings that the program produces won’t be ideal, and 
the requirements will vary from printer to printer and the labels you are using. Therefore 
the user will probably want to change them. To do this, just edit the program and alter 
the assignments to the necessary integer variables. A REM statement is present to help you 
do this. For example, 1% controls the default setting of the Indent. The dual column label 
Program is called "LABELS2’ on the disc, and the single column version is ’LABELS1’. 


The screen shows some further options. 


F) Change filename from default of ’ADDR’ 

S) Save current settings. As we have said, there may be some experimenting to do before 
you discover the right values for the six parameters described above. Once obtained, it 
is possible to save those values to a file. In this way it is easy to keep tried and 
tested settings stored on disc, and just load the ones which suit the labels in use. 

L) Load settings. This loads the various parameters with the numbers found in the file 
that you specify next. Notice that both ’S’ and ’L’ Save and Load the label filename, 
as set by ’F’ from this menu. 

D) Set Default values. Pressing this key causes the six parameters described above to be 
set to the values defined in the program. 

P) See below. 


Page-104 


Utility disc 


= Eas ow wea 
* Somer amy operating system call. E.g. Catalogue the disc. 


(Gee “PF Gpwites the user to insert the disc, whereupon a check is made to ensure that 
Ge Se comterting the labels can be found. If all is well, you then have the choice of 
Stier = screen test (S), or actually printing the labels via option (P). takes 
® Deck & Ge lebe! menu so that the format parameters can be changed if needed. 


Que= = soeen mst or hard copy is under way, you can terminate it by pressing [QSaUN. 
Ties pee cam perform 2 quick check using only 2 or 3 lines of labels/paper to ensure that 
Se eee & & your satisfaction. 


Si=gic column (LABELS1) 


Tiss press opersies very much like the previous dual column version. Obviously the 
epien of chemgime the number of columns is no longer present in the menu. Apart from 
Ss & com be aed in much the same way. 


= = wert peleting out that it is quite possible to use this program successfully with 

Se of mere columns of labels. Just set the ’Indent’ parameter so as to print first of all 
@@ Ge ‘efomest column. Then rewind the backing paper and change the indent so that now 
Ge Gels appear om the second column and so on. 


‘Tiss peegrem bes some advantages over the previous version. One is the way in which it 
wo “peel pour labels centrally. It does this by examining each address in turn, 
“weculemmg “Se longest line, and counting the lines. Hence it can justify the output in 
Sect @ werticel and horizontal sense. 


“Gioemslly. 2 warming message is given if an address is found which either has a line 
Wiech well moe fit im the defined label width, or has too many lines in it. 


= weewle be possible to modify the program so as to send a ’condensed mode’ character to 
Se presser. In this way, you could increase the effective label width. On EPSON type 
grommers, code 15 decimal can be used to do this. i.e. use 


Condensed printing is possible on some daisy wheel printers too, but all that really 
Geppens is that the characters are printed closer together, not smaller. 


“% general poimt applicable to both of these programs is that whilst producing labels in 
“= wey is very rapid, it immediately suggests to the recipient that it is a “circular” 
Sype of letter. Assuming that you have a daisy wheel printer, you may therefore wish to 
greet the addresses directly on the envelope. 

Te achieve this, you will first of all need to change the “label” parameters to take into 
account the size of the envelope. Again, this calls for trial and error with plain paper. 
AGcotomally, it will be necessary to include a prompt in the program for a new envelope 
® Se inserted. Another REM statement is present in the program (use to find it), 
mod tbis illustrates the extra lines which are required. 
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MAIL MERGE 


File: MAIL 
Associated file: ADDR 


This utility will be of value to anyone wishing to produce a ’standard’ letter, but give 
each one the appearance of having been produced individually. 


The main requirement is to create the main body of the letter itself. This must be done in 
the text area, not in any of the segments. 


The mail merge routine can be used to advantage here. Whenever you have to enter details 
which are specific to the person to whom the letter will be sent, just run the segment 
program and a choice of possible options will be shown. Some of these are; 


N) Full name. This is the very first line of the address block in the data file. This line 
can be made equal to “Sir,” if the name is unknown. 

A) Complete address. This is taken to be everything bar the first line, which is assumed to 
be the name. 

F) First name. E.g. “Sue” in "Mrs. Sue Hall”. 

L) Last name. Fairly self-explanatory. Notice that the routine will check for the presence 
of titles such as "Mr.", “Dr.” etc., and include them if given. "Mr." is assumed in the 
absence of any at all. 

S) Signing off. This will normally be ’Yours sincerely’, but if ’Sir’ has been specified as 
the name (see above) then it will become ’Yours faithfully’. 


To insert the appropriate data into the letter, press the relevant key. This will TYPE a 
PS (Print String) embedded command into the text which, with the aid of the mail merge 
program, causes the right information to appear in the finished document. 


The program will take care of letter case in the names. Thus it will produce the word 
“Smith” from “SMITH”. 


E) Exit to text, without entering any further embedded commands. 
P) Printer options. See later. 


Printer options 
Pressing ’P’ from the sub-menu offers the following options. 


F) Change filename. This is the file that contains the names and addresses. An example file 
is included under the default name of ’ADDR’. 

S) Screen test. This enables you to preview the letters, and make sure that each one is 
satisfactory before printing it. 

P) Print letters. This provides the hard copy versions. You can interrupt both the ’screen 
test’ and hard copy options by pressing [J@iUgN]. Be prepared to wait until a document has 
finished printing before it takes effect though. 

E) Exit to text again. 

* Any operating system command can be given, so that you can change drives, catalogue the 
disc, use FX commands to set up the printer etc. 


activates the original sub-menu, offering the last name, full address etc. 
There is a demonstration letter on the disc, imaginatively called *LETTER’. Load it into 


the text area, and use this utility to produce a *personalised’ copy for every name in the 
*ADDR’ file. 
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Tis & = utility which will enable the user to list the contents of segments and the text 
— 


The fies lime indicates the currently selected target area. This can be the text, or one 
of je segments. It may be changed by pressing the appropriate key. 


&° will comse the target area to be listed in full. In this way you can see exactly what 
@ qumteims. and decide whether to delete it later on. Notice that ’paged mode’ will be 
selecesd, so that you will have to press when the computer stops printing out 
tomes. GEST may be used to abort the listing operation, something that may be useful 
@ pow scert listing 2 long document. 


"D peowides «2 listing of all segments and the text, but only provides the first 22 
characters for up to the first carriage return, whichever is found first) of each one. If 
yee pet 2 SEM statement as the very first line in each segment program, then this should 
qgeewade <nowgh information for you to identify it on the basis of this one line only. 


Netece “het the number of words that each area contains is given. This gives an idea of 

je size of the segment in terms of the number of bytes. On average, a word is taken to be 
sm ‘lemers (Sytes) long, though this is not a very accurate approximation for programs, 
particularly compacted ones. It is a guide nevertheless. 


The option is also provided to run or delete segments, by means of ’R’ and ’D’ 
eespectiwely. Deletion of text/segments must be confirmed before it is carried out. 


Ga wit! move the user back to the original screen display. You can also exit 
Gieectly wo the text or a segment, by pressing the necessary key. E.g. ’T’ for Text etc. 


Feem the “Memory status’ display, ’E’ will exit to the currently indicated target area. 


MULTIPLE COLUMNS 


Fille: MCOL 


Assoctated file: DOC] & TSPOOL 


MOOL is 2 utility which will print a document with several columns per page. The minimum 
wamber of columns is 2, and the maximum has been set at 5. 


The first step after entering the required text is to spool it to a file. By spooling 
imems option 8), effectively what happens is that the text is previewed and everything 
thet appears on the screen also goes to the output file. Thus extra spaces between words 
(Ger jestification) are present, as are carriage return characters at the end of lines. 

Tie MCOL routine uses this spool file rather than the text directly. 


DOC! is 2 WORDWISE PLUS text file with suitable embedded commands at the top. When 
speoled with menu option 8, it produces an ASCII file in a form suitable for MCOL to 
werk on. This is TSPOOL, another file on the disc. 


The embedded commands that you use in the original document are important. For neatness, 


§esificetion should be on (JO), but the line length also needs some thought. Suppose that 
tGe final result is required in two columns, and the paper in use is only 80 characters 
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across, then it would clearly be no use to select a line length of 50 characters per 
column. In this case, allowing for a gap of about 5 or 6 characters between columns, a 
line length of 37 might be appropriate. 


To try out MCOL, proceed as follows. Start by loading MCOL into any available segment, but 
make sure that the main text is saved because MCOL will destroy it. 


Run the program by pressing and the appropriate function key. You must first of 
all select the required page length, the number of columns etc. 


“F" initiates the formatting process. A short beep is given when the program has finished 

executing, and the main menu will be found to be active. At this Stage the finished result 
can be printed or previewed in the normal way using menu options 6/7. It is also possible 
to enter edit mode to see how the effect has been achieved, although the text will appear 

rather jumbled up. 


BASIC UTILITIES 


File: BASUTIL 
Associated file: BSPOOL 


It is a fairly well known fact that you can use your word-processor for editing BASIC 
Programs. The advantage is that the word-processor’s search and replace facilities, and 
ability to scroll in both directions, make creating the program much easier. The *SPOOL 
command can be used from BASIC to produce an ASCII file, which represents the original 
program. The keywords have been detokenised however, so the word-processor can deal with 
them as normal text. You create this file by typing 


*SPOOL filename 


from BASIC. Then LIST the program in memory (either completely or with specific line 
limits), and when it has finished, use 


*SPOOL 


to close the spool file. The file (’filename’ in this example), can now be loaded into the 
word-processor. 


An example of such a file is on the disc, under the name ’BSPOOL’. Load it into the text 
area and examine it. You will see that there are some unwanted features. 


1) Line numbers are present, padded with leading spaces if necessary so that the numbers 
occupy five characters in total. 

2) There are ’double-bar’ characters at the end of each line. 

3) Commands such as LIST are present near the top. 


An initial step is to tidy up the program. Option ’A’ achieves this by removing all 
unwanted material. It will scan through the text area, and take out all lines which do not 
start with a number. This gets rid of items ’3’ above. Those lines which do start with a 
number will have that number removed, and trailing "|" symbols are stripped out too. 
Leading and trailing spaces are then removed. The whole BASIC program will now have been 
tidied up ready for any further editing. 


Do not be tempted to remove all the spaces from the program at this stage. It may not be 


tokenised properly by BASIC if you do. Only when working in BASIC, which will have a 
tokenised program in memory, can you remove redundant spaces from the program. 
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Te gt Ge progam back into its tokenised form, you need to make sure that the commands 


sie 

austo 

ame present af the top of the text (Option ’A’ puts them in anyway). Then use menu option 
| @ sewe Ge text under any suitable name, which for the purpose of this discussion we 
wel aeeme & MYBAS. Enter BASIC (using *BASIC), and then type 


SEXEC wYSBAS Pggte 


wed press GESSTRS when the disc drive has stopped running. The tokenised program is now 
=ady = = 


Splitting multi-statement lines 


Opmen “B also operates on spooled BASIC programs. Its purpose is to split up 

mal -stetement limes which, although beneficial as regards memory usage, do not 
cemiribete towards clarity. BASIC "toolkit" ROMs often provide routines for compacting 
Qeegrems. Rarely do they allow you to reverse the process, so this simple routine can have 
gemme practical walue as well as illustrating WPPL. Minor complications in the program are 
te aeed tw avoid splitting statements after an "IF", and to allow colons between 
Quetetien marks to remain unaffected. Thus lines such as these are left untouched 


Nettce thet the “garbage remover” (option ’A’) will delete lines which do not start with a 
maummber. so it should be run before option ’B’. 


Forming multi-statement lines 


Sa sdwantage of multi-statements is that they occupy less of the computer’s memory, 
Secemse cach extra line in the program carries an overhead of four bytes. To make your 
peagrem = short as possible, it pays to compact it in this way. 


Opeen “B w split lines should be run first. It may seem a little odd that it should be 
Gecemary to split the lines up before joining them together again, but it makes the 
Gumpectimg rowtime very much easier. For this reason, you are asked whether option ’B’ has 
@ireedy See= rum. Anything other than ’Y’ takes you back to the sub-menu, and the line 
spitcieg routine can be invoked if needed. 


Lome pieice is performed intelligently. Nothing will be added after an “IF” statement or 


® command. and DEF is always left at the start of a line. Likewise, REM statements do not 


Gewe emything appended to them. 
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